“Calhoun 


Institutional Archive of the Naval Postgraduate School 





Calhoun: The NPS Institutional Archive 
DSpace Repository 


Theses and Dissertations 1. Thesis and Dissertation Collection, all items 


1992 


Alternatives for developing user 
documentation for applications software 


Clark, Nancy K. 


Monterey, California. Naval Postgraduate School 
http://ndl.handle.net/10945/23525 


This publication is a work of the U.S. Government as defined in Title 17, United 
States Code, Section 101. Copyright protection is not available for this work in the 
United States. 


Downloaded from NPS Archive: Calhoun 


Calhoun is the Naval Postgraduate School's public access digital repository for 
| (8 D U DLEY research materials and institutional publications created by the NPS community. 
«ist sia Calhoun is named for Professor of Mathematics Guy K. Calhoun, NPS's first 


NY KNOX appointed — and published -- scholarly author. 

ia) LIBRARY Dudley Knox Library / Naval Postgraduate School 

411 Dyer Road / 1 University Circle 
Monterey, California USA 93943 





http://www.nps.edu/library 


, 
” i 0 4 bit RAP 
v2 ee, ee 3 af oh: i} a. UN: 
' ms ' 4 ° fica” ae q 
' U : 
CURE 














t/ , 
Wh fo 4 4, tigate F 

















































































































































































































































































































Ya' ¥} } 
x “3 é 
DE GU Gh GSR ANS so 
nN ve Si > ‘3 8 ary ae, % 4.8 
“ P Py 4 p s , 4 4.79 ax 4 
: ' p te . ee ms gee, ENS: x 4 aw oe me RN X. OMA yo 
ee co Nee Ce aN b] 1, 1 ole fy aes 4 4'% ‘y . i, adh r*4 \ é ‘ miss aay Pai *'g 4 =f 
' p 4 . 2%, to % 4 4} =. it } ton [he bit at oe: ty Ce kad ats : 
anc Pe eel fee i ey or ‘ae vias ‘ La , H a Ms , ; $3 Y ie 4 mL) Vike j 
ees Cae sp’ one a ae 4 nit viph Qaeta gE A ate BY oy AY Atak + os Pans § aA 
3 : ae od " af oe, ein € ist 5 ‘ Weis! ie m4 yah fA Anemone \ 
: . = Sg Se A ae A sana aa ane Pyare yes” a abgiy bt 
ar : oe Uns © » a ?> i A a . sy 1, : AUS Kt 1 1, Ve 2 RAR in f ni 
° ‘ x . , ' a4 4 ; ' 7 ; yen” ' ‘at n vas went ; 
mike er Rare ee Se BAK AES Nah areas %, 
: “ eh oa Be a7 ; 44 eS: 7 \} 7 a “s ay A Te Ae ac . Aaa Ae tO! ee fous 
* * . : + bes : ‘ ‘43 Pay oe ‘~e "whe Jy “fe ab . 
: + wy) wae? MECN MCR RT eer anes RATAN + SA cathe g iat: Hf aes an ip ta: 
‘ ) 4 y's La Soe r RS ioe i} af . . { pres a. ' h, oh iy! vA a's NS ve : hi} Loto! aL “ rie beth sly lors Peod Gat Oe 
AU ASUS ap ih a abs NSN Sa Re SS 0 SA SEA ay nah eal eas 
as . Cp ee a Mee. WT, va A? Hy WROD. RN An Malis re Ts Joe Lenn: gE ny agnany 
oD ey . oe yee ee padipr rare a A en yA are POON ig sek Lede eek erg To kuate Shap eh te ty ~ 
" ; as ab M4 fey iS ge ay! A m “UM “Sy Sees ae soy Ait aa peta Shiau sete a Tot fae din tem, 
s ’ a 5 9 J e mh ye uy He ey a 8 -_ y 
. : P , } 7 thee Sie J ae A ii Cae AA ANS, A Scan. i maby oti a 4 ee men es see sige 4: anew & 
rY a Me laces vo beds a aia Mn Aye: Nan AX 4h 'y a Tew} Bs pal i Cpa ePeg ey 8 ay: abs nah WAI 
ed yer er ire RY a WS CRE Recaya Nye ahh a ACen A Se a ith a sake ey a cate 
ret hae ot x 3. we tS om | ‘ t » % 
Re Sar Pints wy ss a te AE ik a ay 4 24, “ an yh - ze ag at Pat. a he See “iN re sae sry t oh See 
I ee 1 niet RE Tick oie Mee eset ay tay coe nee = ye ee 4. ew 
i ° ‘eae A ‘ 48 + , th : i ey ere 7th % 
- MF , ' ‘— er ‘ fee , hey ty any iMya yt a ae ¥ at ¢ euch ¥ inva ty ik ah ak Rese: i Nena) Bee ent 
‘ ‘ . : } @ SP eee go: 7y ue oA fe Loe We ts Ld oe Sah ee ~ - i ae? 5" Sats sae “4 } a apa oe 
| etre ' ee Reece : TNT lk Tn tea ats *S Apes fa papel erty hae ss 
] : pean “ a arqtgcnt alas x ot dn abies wes tS ayy a : es aA Sy 34). LA ‘yin Ry. ny eee eqaanhoet See estes 
F : a ‘hp i 1h es m! a; eee a wage, Sy she mE caine » ert aaa é 
’ 4 a e4 a y 4 vr! ¥ “ Phe She % YAN 4 ef ? ne ee ovata hehe) Vn & @e tens br 
a UP u 4. be al Fao hy of ay Ane agile ‘e Ay ™ . 24 Qeath ier bh are * 5 
ee Pipi | a HUA $40) eA Weed 9 ye wher Ay . ake pratensis 800.4 © 
> 8 " : I? . ih ey a 4 a8 yarn Ne MALEATE: TAU SY ein alae. Ua giasre my 
2 ws ¥. . , | a . H tr». }y.t Rab avant oa Wy me ay a“ ’ age os he naesion 
mn F Vx gh ? . ‘ und §:4 ce) ae a veh ml a", et tea @ A rife aimee 
SEM a Ao TS RI ca oe Dr Reis AMA STS Raa ue Ree eee : Cake ae 3 
: . » . 4 4 “hae AB ~ a) : * «wt wh ‘ bo yelag any He hi ane inn re ae : igh : iets Ps Oo 7 [Rrocewaseayen 
pees Ope” Ys a ey <¥ it N ih | Fame ha acy S1teae 9. rs fete aoe ‘ vata! ids ara & mela be ie. coon ce ea en 
. 2 eres ie OT e Vie? oa 8 ate ott ‘ 4 ‘a SP yates wa why asy gins tA : a» : : durin Soefaatpneacaction sen vicnreepienon 
‘ sofas eet erin be rk 5 talon “has NS wore ‘= P react ia BEALS A Shae SAA Vehiaeem,  .% , Rak irae rack apeagedl se snare 
e oq. ' F] aan ¥ de | ie | Lae Je | se % 2,1 fais yale ei s 14 Wy sty hfs “el ha ae ie : ee m pies 4a agte Peet nagar 2 Saree 
. es ‘ . fey? te aie eB le Ny Wai a eh Pinwiererp AeMebat'y se 35% 7 : peeeea ci way ) ana Sng t "ARAL a eee teens os. 
' ‘ ae % « e\'r st Lig aes otter ith + LS ah , BQ et Nye 9 (/ San 4’5 ie veka Mh 7 Lal orn Cae arate; hve week . ie or tert 
' ® ‘ oe Ms Res aia abate ys 4 eR a ay IRS ttn, 7 wn Sa, ay a hyd Sat a7 Se nite rege petseery yoo ren 
: nae eee pie Hy yg | Dhadat8 aieye “sa eu 128 ate hys ‘4 ee he ith Nha Ae ea! RAN wt. a ape eit ; ee = = 
oe : ee te Sve oe 1 i -y'9 He a m FP > Ss. aS et teh ye = of . x oy Ae orm ras Ry ie et Mae at Mate, 
a ae ae . reg € ae). 4 w ar af i the Alle PAM ids MiZseod wyatt i iene, as An’ A iy i inet ut ay h Deda rer Senet oan me pater vlies yeahs: care aye 
‘ °- a Rt > a ieee, we Ne) hy wii tina atios AY 4! mage sae WAtaal qin Ate, SVN antss te eat he Oe ee raIe no Lie oe omen 
' . nd ’ 7 Sh wae tvh « 1 . oI Te ag Rava. eae a eee 
‘it ce 4 = Se Rat, he oth a Ww” SERS " Pare, ASX Mi 4 a rte ye poli Manda Aap Rhy Aa Bae Cy gh dome, 
; » - utaee REIN et} A a Vy Sar A r Tey ay s 2 5 a 6 he Ca 8 ae at i . vt A et ve "elon y Ad im t & Reig oF lel ied : fein DeFeet a SAA ca agen Ses 
la fq ete ‘ ' a Pg ‘ ? oan hy &" z i 7 
; ees ot e . : sPUts ~ op a ie “aeats eo) re jayne 5) ; The ie ene ape eet oid an edna ena ae —— 
ea a = 7 ok . wy ay % AOR tt a eset a ci a eee, pe erro ary ple “Arete gai iano corte rae 
e 7 A 
. : Ee , 4 . ss ee rey OP ee aN hc a RIeT nit hs at i ‘ avis rv Fatah en ee le toy apt poke 
by ie at tye x ‘ y ba ge af atte orm xy , fan pie 252 
ue : bY Uses ‘np ar? m x} ary tne % e- neh al r =e ; 4 ; EAS lect 2 ale Toy Rae 
e be : er, ' a re » Fete by ets ae? ees ; Pat hlin br d ie hc ates iret teitt 
' ‘iene ss H SUP EAN Si Creches hy ioe Py xy se see SRE ed onde in teks warn i 
. a ae ys gsatgtaty A ostimbes yey. - sph far watyy mat giant debs Set Rae eee eee Soiree TK 
i : } asec! tines: Pew mht 1 Oe Sih “era! $8 wy b u bor Lb ke es le op dae t= Wee Sen 0 oy tp rer 
* ¢ : . e , ’ au % Weveals eT Se Se A Fs, “ba 1H? ¥ be Me! *¢ y vr Faye aos Sli ‘ Mass vee Wind Pag oy Wns Re 
. " ' »  atey a 7 i i eee SP de} é Jain ots a fe*ne : at Nee pas Wee he Lem 
P , es ny aE os'hs 4 : i As yee a - 19-2n. yh he han ‘ 4 : A “Petar ap 4,4 < nwfaie ae Se s : po ’ wt gy by ere! oe Ye paces eres 
as : * ee 2 BUN Mal fon BE fant eee ss hes. Lyte yt RD Are tA x : * eae ea 
e ; y 4 Nt) an eT 3 a Ae 7) | a8 Sieadnralyss +. ae “Ya oft ail Pe 1S) ai Sein IS rs BES 
e 2 e a* “ 3 fon aa r . it nt wigty” “s a ec) : “ae Po Tot ey s ehhh %' 2 uh: falta ee hot at ae 
i ys } t rs "er, e ve w% : Fil ata ae ety ea. Heath AE x i i 7 ~ ates EN C = 
tT OS te lg eee 504 hy A le ce Aho eee ee Magic wal a ated ashy See es $8 ae nies Saas 
. . A Ie Oo 2 2 uF T yfees ye Nelas i - bee fits ‘Shack pa; ha . a 3 
; a ay : Th : 3 ees a ee (aos RSE) Ue ; ', ars rf we es Ex ry tay vi . £3 Le) ’ pe. \ aR ty rer eh potas aateh Were one Ree 
‘ e ' 2. ‘ Us . 4 "yg 3° § " ‘4, > %' = fo ak ah hhh oti ae ft r BER AN ga 
‘ as G oo ‘ arte o * ' 19 | tte ey watt: ge, yen 14a i hat x Wal eagten: ¥ 
j aes ‘ ye ys) Bee ee oe “tgs ap hE Pe ay ie hae m9 “9 Ke eles Ai 4 a Ne iM ‘ Den yuna nadie id 
it Sa. . 7 ‘ A eee dt 2 Vane + No ee tet ey toed s LEAR Saath. hee hy "nf boys Ath 
‘ . * a i ae ee, gq’ vel, 3 mses F) s&s of uk. i at Ye e?s tuted Pn Gd & «leg 
® $ oa Ri wah y's a jet nity 4 . . a > ‘3 Pte | = 443 : “y }, fnty: wq"et ‘. 4 J ED y otek 2 
' eae a shy et) ov e) A a. sy Bd ce = Kuo vn A if ‘Ke Ooixt 
ry , i = > 5 ao rT trate : Ue . a sae ta ‘ a ay ee 4 ¥ Bt ea ‘3 Peer kaa! aie 4s peas Glo? 
. ' ° ry a . « te age ase * *. 
ry Has! F] s ad 4 hd ye ee : 3 %s uf oF 1 Ht “eh ; ee "s he 1 par a 7 ays heey gh a) - sv ¥ Pee ager thy NH Lawrie zyme 
? ye ary ofeee O° waar e , Seid 4,23 af ity 2} a mF &: aS ty fe Sa Seve: 5 bh cabal pte’ te ttng We: Saal Sine Re ty her "Ate 
' ‘ ‘ we a; et eT, nate fe i Fae Pi SO re ST Wyte tases git ee Oe ae et ie ke yt 
' ' 4, oh ty 7” toa: Sse 2} ’ ie yeh : a Fe ar x pis vs 0" | . a re beta btn an ‘eu 
7 ' ‘p * ' ‘ taeda 3 3 ae fy Aye : Pune ee ‘ ‘ * a w ; > 3 . se °y APO Na tak iby 
eee apien ; voy NG Me WL Tt Cink saat DEANS =n 
R @ RY Ceca : Phy eo el ery °-' %) ; *) ; y ap. “ela, Aus >} wiity't min iala, wh a sSioesett Ree, = a 
’ . ew on, yo od yoo a a ar dt eet ee AB “ela Fei sane Aart con 
Bs Ly ’ , : 1s > =e ? ‘ iter va k “A . ae 92 4 Nae bie 1a Saat Ves: ? bok La tap Py ae mers eS 
r ee 7 ' y tpe% ar. = , ae qe fe . s,s ath! My vt? 0 tlhe w™ poe tg ‘ rary s" *s Bik a; ks wept : — = 4a 
. : oe ' vials oyvete * ‘ “ 1 -~% = 
‘ & Noa te pe. "05 q ‘ : . t a” ae y Wt Fs ws bi ? xs ae Se Me aenes By x arte ge 
ae 4 Be OT I as pele, cals Dee tis ys yy ah! fr . eee sie 
. ‘ ee ee o Ge ORO a ch id gc aes ap Ca ag ae 1 ae 42'S" a ey Feats ar ‘5 a cote oe mdse : Lariat Pt “ 
- a a” : eye S| Ag eas Ie atetgtt Waly |b! ne, ENRIN y : - s 
aes ae) a ag t * : 4, staty yelgeg, F Lab le tho, ie, > Waly pe a 3 & “a a ; uke 
me ‘ nee + > f 2 +i 3, fe, At, Be } a A¥ at's ttyl, al aids! Stat Pr tare > 3 i nw cy Ly . . Aan > BAX 4 + bey “8 
. , “° Sate ptLE tava? § cen Pe Be ‘ (ats 7 p i oN oT. ? Pes 2 POR Cheer kh ek She S ‘ : 
' ane ‘te » ov. a oie yf ‘yg, © Gi ‘J r4 ae bg 8 , - ai o) aii. # e ¥ fe baal? me f ee nhs RPh 3 o4¥Nz ri a : a <=~* 
sana ‘ os fe ° . e 2g" Pee tae ot bh be: MOP gh gets LS veal Were as ie Wu tartiied < "ten ri W : bates 
tats r? re 47S t<* 77. : _ A a ee | tr tats te nS d a ear ees a) yar kL < sp : X if “as 
: sre 4 test + 4 ike Pik er 7s - Da) ” wa et ats c aE aoe nh $u : eating eM Fh 
j ; rae ‘ n % . ty 7 WEL Peat LF Vegery E 7 c , i Mae ety 5 fo Psf Pid it \ : Wan agb a wa ha wit 
n 5 #, ate oe ‘a Py 4 LU . ma, ; ‘ - er , sey bi 
’ : ee ee ie ae U DARA re : re 2 ‘ Paies ‘be | PRS AY eur 4 ae yt A 
4 5 ac, bes ae ALS igee emis ata He Wy fins y iy °° = Fe, a. teeter ae pe 
e « ie, e . > ’ e . oy * . 
PY . ° @r b] f pe’ %, : = « ‘aa / Pu 2 te hf ie yo , fates ‘raised sJae 
: ; a's Pears faurfeeeee y Ba gty! anion 4 . meets . ater V0 183 vi aires Pm 
4 . Sos tate “ene hE Vows eee pate ta a SAY teak, Aa oop 
MME ater HAY Wiathia ays sige Sty ee 
' e Pe, <, * .s r } H =r af 3 ay x i *' 2B % Rete aie ‘ aS. axe 
. U 3 P ‘ y . nS ial 2, e 4 ere 
ee 
e ' 
‘4, 
i ‘ 
4 
4 
op on Ok eae Sages ar cee Se oe 
s - a ae 4 
flee; + : ieee (LORE eee 3x; 
re ee <" inter am a 
¢ A Ps r Sapein Fe ose = Vv F 
° 7% g ; ; Cr ike x . € mp 
: ' Wh Ras : re fi rad 22 ’ feo ine Seeapeee roa nene pte 
aye Peet ‘ o 4.3 " , SP, ALS $ 0 
; 7": tat Ones me vy Ae es A Se tons ‘ oi ‘ sf aig a was saw yy Ete, a, < 
ta + fla Ee Le Sg a * ’ ot ae ope ¥. goed be Be se Lb hy ge i f > > d Mie iN F-™Y?. Se 
‘ay ir ee eee a leate Gat ute Ne a) Eile Phas JO AUP SRE SOBs ae INE cae ee is iin eee tees 
1 ee oe 3 = Sen 0 pirat) a re aeat ‘ea «ee # "IKerapat s +i fie mA 2 ws ae ; Be + es f ae eG Z ALAS = Ree ets nonce 
s : e ; H i ‘ A as fy ’ #.¢ oy ne Cl gt " ., ray ‘stats 20's sae ‘ 8 ed ease . ‘ Bee ; me } ie i o "Te A eas ging mone 5 
: oY ae a a Jee PON Ft eee Brawl gerne. Bip, Rs teed feet ond Py rd Pe oF 
ie ye aos: Wiha) i et ehh oan a 1 ary oe Wet ‘i A Wiser Wee Side Peis “3 as fu". io fs eae eae tee 
: BGr in “tro et) sate Le eet air, Tg Jap. 8 te bey UTEP (oa SR wes a's ‘k J b- AAMT AS 7.8 ; 
’ , ’ ah jae +a) A re ae he goa * Ae yF Pe ange de sh py FA) ‘ fit mr «& snAany, ere 4 
— Pee gee ss? ay +. Ath , Ha ot A eu eo 2 ty ose ie uD, oe ass fing : 2 t5 F PRN 1y apa Pe 
- rset Ll iy rier pegs LM 2 bg Oy aie Aiea AS) @,) Hyer : al mae fe ny sO ad -eey 
2 ' ' PEO aus wt he : ct ae a ae tf yp has < ae # iy as i "ye ae Br °F wane pees Ld ¢ ne os apa 
“ r) man 7 Oe ear aT gas as 3 i Lean Ps es, ; + ity ‘4g " AA Ld 070g 4a v.e 2H. 80 . 
: "4 1. td oe easy Bee Sue leniee r Aas 
ae nai," veg fy t of 7h Re tt io 4 < Oa ns ee ae re at of ! Besar a eis a Ek Ba tas 
' = ey i att $ ,? S30, a fers 3 U = : ry & 7 A ane rye oe oF sy 
gee toe Plee ak ?, ' Se po rae e oY * 3° hes, ‘ ! ie ase 
4 f > a Pe ere i invene . oe i sets Fe sy : ; ig 
een bd bd ? F; Fi ” ; a8 5 3"! me BS < EO it! 47s hing A i " ed 3, eet ‘ 8 Ags, Heh bid penne s r . ce i wal ae 
re ees Oo * ihe | tet s eee ae ced iene, Ze af # hed “5 bot & ay Fr “4 was sur * £5 rae b oF OF ee nig fevem 
’ ' “qafy se aoe - i} 4 . . ¢ ‘ VF SG . ; 5 
> ts 3 i . PG Diss i ese Gee iy eee aein an BA aS, ears “paar Savi vy Aare ee Re ey 
veg i) ae mae ree oe elie EER ea Teed Matte aia thet Ret et iatit: 
Lr) #,! z ve ee i al Ca i) Hoga Be ? . H ’ r iad ¥ e t 
i : Dee ee relay fa a nae sit eee # hes i weg re : 4 i wi ze 
; : betes, 0 . > J mH ag his io i é al At Fae io w vag oF 3 7 U é Vo oor 
i ? 1s 4 ‘ ' } “ Oi de . CE r 2 meg @ ? so 
toy OF : ee i. Voy } ’ P : eae * Gham ast 
cane en er PY te * We fog: 2, 0h te fe re ie ©. ne ar en are v) 
ver) , * 2 A ti st ebeaje ” Ae rie ha ieee é ive fi Me ey oe 3 x3, ; my pte, os ae P see de wee oe bated ace 
Pe ‘ eich CAI eI Aap ‘ v “vi. : is re 
oe i ee Cea Oe eet Fo Ps) lee a iy ne ‘edit Fe i eer ee ae eae 
e ' iat ere ae ia Mosse ioe re ee | Se “Ay st ler igh og ou gi ~ 00 Wa 47 j yee ue 
as bs Pa) t fe a) © Joage s, ) vié 4 i , ‘ a ee a “14 ee oi a id ois POT, yp ae gras onee a 
a er “6 | Pin Ge Udon! f, nF 4 9 83 a LES ve “i > ay SA hag ede bee e resi 
a o4 nae a 7 re den bee LED Cee ey A r 1‘ 5 a’ ah tite by 4 oes 4 , ae ae 
i e at A } > 2.8 ’ type % Ps Wadi Babee ‘ety? sf 
’ : ve | vuln fo a ates ai Vase vp as iv f,f-%. $ he ew ite 
‘ j ie , et ie | af A re as a 4 asf try Sa! gt zi ry: 
Z Pe eer au : ’ ; pelea 8 at ¢ epee ee at 7 ba‘ T, 4 : A 
‘i I ; DF hides oy F gitire pM og aap yess? > rape 
i lM ON IRE BOSE ae Te eg ale vo 
7 N Cons Ted wl ae Wr at he Oho cE Pv is r) 
oe o a2 ur Fie ao Sane RAS by Partie’, ted phi eke mate ne ea ay 
5 4a. ¢ » < er . . i” * ae 
peek Lalit, ane ot ee ay Nae KKM, A oh he, o ute at ais 
‘ ' ‘ “as * «39 4 Rat 2 ae ff ¥ Fa ss 45 a. bE ¥ ey 5 { 
‘ $ . gas : t We i eer Vp ed ie a A a sede i ap fe «hod 1 fas 
' ipa Rumer De Ce out oat ney abe aed Pot, a a ¥ 
on i Lg “a ki Pdi: e Un Varvirvs , 0 . ely oF Fe a * Sisiytie aes re ; 
- td ’ o gbe v eds ULe, 4 ae ere ned ee SOR HAE PH 
tapes ns ver ce . ie vl a Vf Fah epe Dede ue of we tt 
‘ r ae Rien oe seo ecneant is dh Ne = 4’) re Be Fee ny. hag i? 
a acres ee Dee ad eth teat se lakers fom ei 
e! 4 le a é 
‘ Be Er A Vas ria) 534 f ; nee te: vee Sad 1 rian hers RP pe dar 5 ‘ aie sense 
we 4 *% é Fe vt aay 4.43 ee de 8 yee yao i ‘t 9 sdk bag Yaa wy bo wild ny? Ow b OL F057 \, eve be 2900 | a iy $ Seoebye OF AS. ory 
rs ® « ey) i ; ’ : ‘ A Wed Ve the i 3) i A ttt fe ? dea sete Phd why Maes ue hr ROR ALR Re Agt ee ae at : Do epedt A ft Bh Sheet se oes 
6 ‘ i “f ee ee ee Me sc des 9 Fated ae cola s Wigte, os 
54 oe, * ; es “n'y : oo ) LA a wrt oT: ae Pas teay wis ely oth ee ety a. 
pe ‘ te iS J e oF, is te aids a % ne ee f er 0 Oth ane by itt ~ Beir eye, ie Regd died AY 
ae i - o? re 3. aaa wf woke Sat 7 Secute ‘ “ve ae she ry cesraty oot ome oe ry; 
EE Aa A f ; 6 y SL: : Ve mes Hectic ‘3 AY ee, ee 45 > ‘artes js pases ah : ae He * 
‘ Siesta ig = Ab 4 erales , 0a ee wi 5 ,' AA hy ia td MOUS Nate iain ee wy ‘> v4 Dis ne Shs 
: : verge i re ; 0%, ee }oo ot PT r ie F 
a te th Aero Al iia 5 A es a Ay gee - Swf, 
e . \ ’ Cae | ; 1, ry he 2 y O,0e74, 4% asi 
; + é Ade es) va. ‘ . yy yi, Pe nt ie ain Tag 
. al Le i oe 
ae t - ry a fe > 4 Le ey ae heey ar as tty “ AD "a ; 
. j tt (aus tee HUA GT DOS OMS 1¢ 
OF Te i 2. sine Pee, yp aye shales TY Arie eee Pa 
ee : . ee } on gts, A .. Ka ee " . oe fash J ri, ite vee ares tee 
Poa - H 5 five ¢ \ . 7h 5 RAS, 
, ‘ De yey. 5 Pe eee RAT eT x i ene A HIBS KAE AHFOAV GTA wNS 8 eer: heey ae 
; 2 ; i : g ' ' j t  f r mo) ' «Sat + Mt . ¢ A a: ; yO td = . CRA. e j - . 
Fie ve st ae ae hoe 4 a. li. Biot oS are o% ; cig ve sO TD WON Vo Oath VS ARE, Si 
,s 4 ee pe y99 7) Sih * pes ia i ay sone ri ‘id i ; 
a4 e oa ay eds) se aes LF fn ae “4 : 2 
‘ a, ; : eee i A vee og uae & hn 
< bf . bn ee etd eB ? pL ak ss ’ aye nif bo Md 
oe e ’ » 4, : tL i” 
? we , cs e eu Be 4 ! J ni? is Timed: “f , y - ERS gat 74 > 
r 33 e a .} } " r ‘ a oe Ff Yah Ws oe * * 
leas es 4g Ms Pa | i Seas ee A 
‘ 3 ee yaaa Tee Se Te ey ne 
. = @ teat al A e ? eoua 
ry i ot , 
Os st ae UP ya 4,4 ya re 0 we ee 
cd ° 7 


mene rele TY pee BZ 
ap iG be CH TIT ORE 
~~ om at {eu} om hee 











NAVAL POSTGRADUATE SCHOOL 


Monterey, California 





THESIS 


- ALTERNATIVES FOR DEVELOPING 
USER DOCUMENTATION 
FOR APPLICATIONS SOFTWARE 
by 


Nancy K. Clark 


September, 1991 
Thesis Advisor: Norman F. Schneidewind 





Approved for public release; distribution is unlimited 


125/792 





UNCLASSIFIED 


SECURITY CLASSIFICATION OF THIS PAGE 


REPORT DOCUMENTATION PAGE as te 


ja REPORT SECURITY CLASSIFICATION 1b RESTRICTIVE MARKINGS 
UNCLASSIFIED 
2a SECURITY CLASSIFICATION AUTHORITY 3. DISTRIBUTION/AVAILABILITY OF REPORT 


Approved for public release; distribution 1s unlimited. 
2b. DECLASSIFICATION/DOWNGRADING SCHEDULE 


4 PERFORMING ORGANIZATION REPORT NUMBER(S) 













5. MONITORING ORGANIZATION REPORT NUMBER(S) 









7a. NAME OF MONITORING ORGANIZATION 
Naval Postgraduate Schou! 


6b. OFFICE SYMBOL 
(If applicable) 
55 






6a. NAME OF PERFORMING ORGANIZATION 
Naval Postgraduate School 








7b ADDRESS (City, State, and ZIP Code) 
Monterey, CA 93943-5000 


6c. ADDRESS (City, State, and Z/P Code) 
Monterey, CA 93943-5000 












Bb. OFFICE SYMBOL 9 PROCUREMENT INSTRUMENT IDENTIFICATION NUMBER 


(If applicable) 





8a NAME OF FUNDING/SPONSORING 
ORGANIZATION 





=—=_— — 


8c ADDRESS (City, State, and ZIP Code) 10 SOURCE OF FUNDING NUMBERS 


Program tlement No Proyect No Task NO Work Unit Accession 
Number 


11. TITLE (include Security Classification) 
Alternatives for Developing User Documentation for Applications Software (U) 





12. PERSONAL AUTHOR(S) Nancy K. Clark | 


13a TYPE OF REPORT 13b TIME COVERED 14 DATE OF REPORT (year, month, day) 15. PAGE COUNT 
Master’s Thesis From To 1991 September 132 


16 SUPPLEMENTARY NOTATION 
| The views expressed in this thesis are those of the author and do not reflect the official policy or position of the Department of Defense or the U.S. 
| Government. 


| 17. COSATI CODES 18 SUBJECT TERMS (continue on reverse if necessary and identify by block number) 
FIELD GROUP SUBGROUP Computer Documentation, User Documentation, Applications |Jocumentation 


19. ABSTRACT (continue on reverse if necessary and identify by block number) 





The preparation of software documentation is an iterative process that involves research, analysis, design, and testing. The writer must havea 
solid understanding of the technical aspects of the document being prepared, good writing skills, and, most important, an understanding of the 
needs of the audience for whom the document is written. This thesis describes the theory and steps taken in developing software user 
documentation for applications software. The final products are two prototy pes of user’s guides for applications software programs, specifically 
WordPerfect 5.1 and dBase IV 1.1, installed on the networks in the Administrative Sciences/Information Systems Computer Laboratories at the 
Naval Postgraduate School. 


20 DISTRIBUTION/AVAILABILITY OF ABSTRACT 21 ABSTRACT SECURITY CLASSIFICATION 

EK] UNCLASSIFIED/UNLIMITED DO same AS report LJ otic users | UNCLASSIFIED — : 
22a NAME OF RESPONSIBLE INDIVIDUAL 22b TELEPHONE (Include Area code) 22c. OFFICE SYMBOL 
Norman F. Schneidewind (408) 646-2719 





DD FORM 1473, 84 MAR 83 APR edition may be used until exhausted SECURITY CLASSIFICATION OF THIS PAGE 
All other editions are obsolete UNCLASSIFIED 


Approved for public release; distribution is unlimited. 


Alternatives for Developing 
User Documentation 
for Applications Software 


by 


Nancy K. Clark 
/ 
Lieutenant Commander, United States Navy 
B.S., Southern Methodist University 


Submitted in partial fulfillment 
of the requirements for the degree of 


MASTER OF SCIENCE IN COMPUTER SYSTEMS MANAGEMENT 
from the 


NAVAL POSTGRADUATE SCHOOL 
September, 1991 


Fal A 


ABSTRACT 

The preparation of software documentation is an 
iterative process that involves research, analysis, design, 
and testing. The writer must have a solid understanding of 
the technical aspects of the document being prepared, good 
writing skills, and, most important, an understanding of the 
needs of the audience for whom the document is written. 

This thesis describes the theory and steps taken in 
developing software user documentation for applications 
software. The final products are two prototypes of user’s 
guides for applications software programs, specifically 
WordPerfect 5.1 and dBase IV 1.1, installed on the networks 
in the Administrative Sciences/Information Systems Computer 


Laboratories at the Naval Postgraduate School. 


pe Bet 


i 


LE 


re 


TABLE OF CONTENTS 


INTRODUCTION 

A. PROBLEM BACKGROUND AND DEFINITION 

B. OBJECTIVES ee ee 5 gern ree 

C. THE RESHARCH QUST TON ee: uel). | ocmCnnn 

De So CORSE 

E. LITERATURE REVIEW AND METHODOLOGY 

F. DEFINITIONS AND ABBREVIATIONS 

G. ORGANIZATION OF THIS STUDY 
LITERATURE REVIEW OF USER DOCUMENTATION 

DEVELOPMENT 

A. OVERVIEW OF SOFTWARE DOCUMENTATION FOR USERS 

B. RHETORICAL ORIENTATION IN THE WRITING PROCESS 

C. SOFTWARE USER DOCUMENTATION PURPOSES 

D. TYPES OF SOFTWARE USER DOCUMENTATION 

E. PROBLEMS WITH SOFTWARE USER DOCUMENTATION 

F. CAUSES OF INADEQUATE SOF TWARE USER 
DOCUMENTATION 

G. SURVEY FINDINGS REGARDING PAPER DOCUMENTATION 


FUNCTIONAL ANALYSIS AND DESIGN 


ae 


ia 


dal 


13 


ay 


ig 


Ze 


23 


Pa 7) 


30 


A. COMPARISON OF USER DOCUMENTATION DEVELOPMENT 
PROCESSES = 0 (6 oh ete (5 GURSRRIRN Es eer er ee ee S10 


B. COMPARISON OF SCREEN AND CATEGORIES OF PRINT 


Di SO ee SSC we Cl 39 

ec: Deo wbGhieooUlioe. <«< + . « . «« »« © «© » 6 #® © © « « 41 

D. PIOMMEMING@E ONAILYSES «<9. 5. . « .« « es ele el ell le 48 

‘ava THE SOFTWARE USER DOCUMENTATION TEST PLAN aT ae aval 
A. TEST PURPOSE ee - | Ser = - eee a eee ee eee eee La yal 

B. Tre Sao bemeluVviMnsS 6 « © se «6 © 6-6 © © © © © «© e i al 

Cc. TEST PLAN er ee ee | | le lw Cl SZ 

De, TEST ADMINISTRATION AND PROCEDURES i) 52 

oe RESULTS AND FINDINGS 5) ee ne rr rr 53 

WC ONG ILUGil@ligeme. Gs ss « « 6 6 « eo bo ell wm ew el a 
APPENDIX A: AS/IS Computer Labs Software Directory . . 5.) 
APPENDIX B: WordPerfect 5.1 Basic User’s Guide ..... 59 
APPENDIX C: dBASE IV 1.1 Basic User’s Guide Se ere 84 
LIST OF REFERENCES Boe 3a & SES a a ee I PAPA 
Pit Paes heme nONwTST . .# . ...*« .« e« «© «© «e e * i725 





Be INTRODUCTION 

There is little doubt that the impact of the computer age 
has affected many in society. We are being flooded with new 
complex computer systems in which acquiring and retaining 
information has become increasingly difficult. The 
technological innovations in the computer field have created 
problems for both system designers and educators. System 
designers are faced with the dilemma of trying to create user- 
friendly interfaces for these new systems, while educators 
must find ways of teaching complicated information to 
potential users. 

The materialization of these problems has led to much 
attention being paid recently to the field of user interface 
design. No longer is it important to just design systems that 
meet the market demand, but systems must be designed and 
presented so that it is alluring to the user. As such, the 
human-factors issue plays an enormous role in the design of 
new computer systems. 

Along with the emergence of new systems, software that 
takes advantage of advanced technology must also be written 
and documented. When carefully developed, documentation can 
be used as a supplemental effort to ease the transition and 
enhance the relationship between user and machine 


[Schneiderman, 1986]. 


Another contributor to the dilemma created by new computer 
production is the system comprehension issue. As hardware 
becomes more complex, technical manuals have become 
increasingly voluminous to accommodate pertinent facts. While 
enormous amounts of this information become available, more 
efficient ways of absorbing its content must be developed. 
Newly developed teaching aids must now encompass the technical 
sophistication of computer systems in addition to addressing 
the human-computer interface issues [Bradford, 1983]. Also, 
training must address a more diverse audience that is not only 
made up of data processing professionals but also clerical 
workers and managers. One way to meet these disparate needs 
1s to create user documentation that can be used by the 
different levels of users and incorporate them into the 


learning process. 


A. PROBLEM BACKGROUND AND DEFINITION 

This is the age of the microcomputer. As microcomputers 
continue to grow in numbers and use, so does the need for 
communication among them. Spurred by the need to share 
hardware, software, and data, local area networks (LANS) are 
expected to proliferate in this environment [Sachs, 1985]. 

Many offices are now sharing their computer resources 
through networks, but even in small non-networked office 
environments, the potential for sharing computer resources is 


present and the move towards distributed systems is 


inevitable. This prediction is based on the assumption that 
most personal computers do not operate in offices alone. In 
some cases, programs and data in offices are shared among 
machines and users via the exchanging of disks. Normally as 
an organization grows, so does its need for more powerful 
computers, larger storage devices, more memory, increased 
efficiency in the retrieval and update of data and more 
sophisticated peripheral devices [Luhn, 1985 de ope 
organizations who want to cut costs, one solution is to share 
their equipment [Derfler, 1986]. This cost-cutting objective 
can be achieved through the use of computer networks. 

Networks offer an effective, efficient way to share 
applications and other resources. However, users need to be 
able to operate the software applications and access shared 
hardware resources such as printers in this type of 
environment. To meet these demands, adequate documentation 
and training must be available. 

Network training must be directed toward students, 
clerical workers, managers, and other users of the computers. 
These target audiences have varied levels of computer 
knowledge and experience, and often possess conflicting goals 
and expectations. Often, user documentation is developed 
without regard for the audiences’ needs. Since not all users 
have the same learning needs or skill levels, the 
documentation may be too technical or too simplistic, too 


specific or too general to be of use. Often, one all- 


encompassing system documentation is created, intended to meet 
all the information needs of all the system users. As a 
result, diverse audiences find the single "system manual" 
contains the wrong kinds and levels of information [Chinell, 
OOO) 

This thesis analyzes the functional and design issues 
associated with the development of software user documentation 
for one of these audiences, the information systems and 
management students of the Naval Postgraduate School, and 
produces reference guides for two applications software 
programs, WordPerfect 5.1 and dBase IV 1.1, as an end product. 
The study is a report of the developmental process used to 
design reference guides for applications software used in the 
Administrative Sciences/Information Systems computer networks 


at the Naval Postgraduate School. 


B. OBJECTIVES 

The primary objective of this project was to develop 
software user documentation for two applications programs 
resident in the networks (excluding the Apple networks) in the 
Administrative Sciences and Information Systems computer 
laboratories which would be used and understood by users of 


these laboratories. 


C. THE RESEARCH QUESTION 

What is the most effective method for development of 
software documentation which will promote maximized use and 
enable greater Produet iv pey Of the Administrative 
Sciences/Information Systems (AS/IS) computer laboratories for 
Naval Postgraduate management and information systems 


students? 


D. SCOPE 

The many problems associated with designing user 
documentation are the variables upon which this paper focuses. 
The intent of this study was to investigate the variables 
needed to produce effective software documentation for users 
of the AS/IS laboratories. These variables were tested to 
determine their effectiveness, and modifications then made 
based on users’ needs and recommendations. 

1. Audience Description 

These reference guides were designed to address an 

audience that represents an older-than-average Bliege 
graduate student. Most of these students have been trained in 
some technical or managerial area in which they have been 
working for a number of years. Most will be pursuing advanced 
degrees in the administrative, managerial science, or 
information systems area, and have limited amounts of free 
time available because of constraints that course requirements 


place on them. Computer familiarity varies immensely, with 


experience ranging from the novice to the dedicated computer 
user to those with both job experience and baccalaureate 
degrees in the computer field. 

2. Design Issues 

Although knowing the audience you are addressing is of 
paramount importance, it is also vital to know how much 
technical information to include, which information to 
include, and how to organize that information in a meaningful, 
orderly fashion. The most frequent complaints about computer 
manuals are: 

e Poorly written manuals. Computer manuals are often 
written by technicians who have no concept of how to 
present information to users without using technical 
Jargon. The end product is a manual that is inadequate 
and difficult to understand. 

° Important information is hard to find. Computer guides 
that are not organized around user tasks are often 
confusing. Users have to expend extra time and effort 
deciphering the layout scheme. 

Considering the audience and issues involved, application 
documentation developed for NPS users should be brief, task 
oriented, and written in common English. Two examples of 
essential user documentation for application software, 


specifically WordPerfect 5.1 and dBase IV version 1.1, are 


included as Appendix B and C. 


E. LITERATURE REVIEW AND METHODOLOGY 
Much has been written to help professionals who write 


computer documentation to produce better manuals; however, few 


address the development of user documentation. These 
professionals perform a variety of roles in software 
development settings, such as system designers, system 
operators, and maintenance personnel, and write different 
kinds of software documentation, such as design documentation, 
maintenance documentation, and user documentation. User 
documentation is the least standardized, supported, and 
understood of the types of software documentation noted. 
Automated systems such as CASE tools, rapidly becoming 
available £Or producing development and maintenance 
documentation, have not been developed for user documentation. 
Development and maintenance documentation writers generally 
follow well-developed standards for the sequencing, 
formatting, and content of manuals; not so for user manuals. 
[Brockmann, 1990] 

User documentation is the most difficult for computer 
professionals to write because it requires communication with 
people who have widely different backgrounds. It dictates a 
type of writing that translates computer operations into 
English that users will understand. [Brockmann, 1990] Program 
users need documentation as a tool to help them successfully 
run and understand a program. They want documentation that 
gives them the instructions, guidance, and reference 
information they need. [Spear, 1984] 

The template approach developed by Dorothy Walsh in 1969, 


in which the writers merely fill in set templates with 


information peculiar to their own system, initially appeared 
to solve problems of content adequacy and organization. 
However, it did not have the necessary flexibility of content 
and organization required to cope with the variability in 
audiences and purposes. [Brockmann, 1984] Replication of the 
best procedures used by the best documentation writers, rather 
than simple replication of document content, offers a method 
to prepare comprehensive and accurate documentation which 
addresses and answers the needs of targeted audiences. Using 
such a structured methodological approach not only aids the 
developer in organizing the documentation, but is also the 
primary determinant to producing a well-developed and useful 
guide. 

The procedures used to develop the user documentation for 
applications programs installed in the AS/IS computer 
laboratories are based on the Standard Documentation Process 
(SDP) described by R. John Brockmann. The nine (9) steps 
involved in the SDP include: 

1. Develop document specifications. 

2. Prototype the specification. 

3. Draft the document. 

4. Edit the document. 

5. Review the document. 

6. Field test the document. 

7. Produce and distribute the document. 


8. Review the documentation project. 


9. Maintain the document. 


F. DEFINITIONS AND ABBREVIATIONS 
Some of the concepts presented here require working 
definitions specific to this study. Also, abbreviations and 
acronyms used in the paper are defined here for the 
convenience of the reader. 
AS/IS - Administrative Sciences/Information Systems 
DDP - Documentation Development Process (Williams and Beason) 
SDP - Standard Documentation Process (Brockmann) 
Software Documentation - Unless otherwise specified, refers 
to USER documentation rather than design, maintenance, or 


other types of software documentation. 


G. ORGANIZATION OF THIS STUDY 

The first chapter is the introductory chapter, including 
sections which present a general description of the problem, 
background of the problem, objectives of the research, the 
research question, the scope, and the assumptions of the 
research project, a brief description of the research 
methodology, a list of definitions and abbreviations, anda 
description of the organization of the study. An overview and 
a review of research materials and literature relating to the 
purposes, types, problems, and causes of problems of software 
documentation, rhetorical orientation of writers, and survey 


findings on paper documentation is included in chapter two. 


Chapter three describes the methods used for executing the 
research design, comparing documentation development 
processes, comparing screen and Prine designs Lelong 
documentation, and discussing design issues and audience 
analysis. The fourth chapter discusses the test plan and 
results and the fifth chapter draws this report together with 
conclusions and some practical recommendations for developing 
and maintaining software user documentation, as contained in 
Appendixes B and C. Appendix A is a matrix of software 
programs installed on the server computers of the networks in 
the AS/IS Computer Laboratories. Appendix B is a basic users’ 
guide for WordPerfect 5.1 and Appendix C is a basic users’ 


guide for dBase IV 1.1. 
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II. LITERATURE REVIEW OF USER DOCUMENTATION DEVELOPMENT 


A. OVERVIEW OF SOFTWARE DOCUMENTATION FOR USERS 

The field of computer documentation is moving and changing 
quite rapidly as some of the finest minds in the professions 
and in academia turn to it as a field of study and research. 
The industry already has moved beyond merely paper manuals. 
It is in moving beyond paper that today’s writers of paper 
user manuals will be able to enter the next century with 
manual-less software in common use. Manual-less software was 
the objective of the Apple Computer’s Macintosh project. 
Although they didn’t fully succeed in being manual-less, the 
direction in the software industry is to take much of the 
paper documentation and make it either superfluous because of 
improved interface design, or put it online using such new 
organizational devices as hypertext. Manual-less software 
will become Bes suitare as contemporary culture increases its 
"intuitive" knowledge and sophistication concerning computers, 
and as the software itself better communicates its purposes 
and controls to the user. Even now, user documentation 
writers are not just paper manual writers; rather they are 
communication specialists who have the necessary expertise to 
design the communication elements of the "user interface" 


elements of the software: the messages, the menus, the online 


digit 


tutorials, as well as the traditional paper manuals. 
[Brockmann, 1990] 

However, experience has shown that online documentation 
will not work unless it can be provided within the application 
program at the point in the user’s operation where help is 
needed. The methods and techniques of communication on paper 
will not be lost in the transition to a new medium, but rather 
become more important. In many cases, the qualities of 
effective online documentation must be abstracted from the 
qualities of effective paper documentation. For example, the 
concept that effective online information must allow for 
multiple access methods of getting to information can be 
easily abstracted from a book’s multiple access methods that 
range from the "keyword searches" of an index, to a "top-down 
hierarchical approach" of a table of contents, to a page’s 
headings that allow Sceeee to information on a local level. 
The idea of "aliasing" in keywords or online "links" is 
nothing more than the application of the concept of using 
"See" and "See also" in paper book indexes. The principle of 
effective online documentation is that we have to move away 
from effective paper documentation, abstract from paper its 
tricks and techniques, and then reinvent their tricks and 
techniques in online documentation using different tools. 
{Brockmann, 1990] 

Several documentation theories will be outlined in this 


thesis. Often, the best solution to user documentation 
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prob lens Ice abeecelectag, SOlutIon: a little from ene writing 
style, a little from a hypertext-linking philosophy, and so 
on. Only one methodological guide remains constant and 
unyielding across all theories: the audience is always right. 
Thus, as many sides to solutions (and their defects) as 
possible are presented. [Brockmann, 1990] 

More and more documenters are breaking out of the software 
design organizations in which they merely massage written 
software design specifications. Now, documenters are getting 
information from such people as the design team of which they 
are a member right from the beginning, from actual users in 
their own environments through the application OL 
documentation specification reviews and early prototype 
testing, and from fellow documenters in documentation teams 
and in structured documentation project reviews. Getting more 
information from people than from books means~ that 
negotiating, listening, and getting along with fellow 
documentation team members, software designers, and users will 
play much more of a role than ever in the past. [Brockmann, 
WSL) "Gone are the days when writing was done after a 
product was complete and writers were given the product 
specification and told to ’pubs it up!’ Today’s information 
developers must work as equal partners with other product 
developers. The lines between hardware, software, and 
information are getting blurred with the advent of interactive 


programming, new input devices, and displayable manuals. For 


3 


this reason cooperation and collaboration across disciplines 
will become even more important and people should start 
practicing it now.” [(Grice, “19¢o) 

Computer documentation can be defined as communication 
designed to ease interactions between computer software and 
the individuals who operate it. Thus, to write software 
documentation, you must act as intermediary between the 
computer software and its users. (Brockmann, 1990] 


Inadequate user 


Human Enors 


documentation can greatly Using 
100% ) Computer Systems 


increase human errors 149 
computer systems. Robert W. 
Bailey categorized the major 
factors for human errors in 


computer systems. Three 





categories --environmental Figure 1 Percentage of human 


errors directly affected by the 
problems, personnel problems, documentation. 


and organizational accuracy 

factors-- accounted for 50% of all human errors and are beyond 
the control of the software or computer designers and 
documenters. The other 50% are within the control of the 
designers/documenters, and, of these, 60% are directly 
affected by the quality of the documentation efforts. 
Training, written instructions, and the human-computer 
interface are all affected by the quality of the 


documentation. [Bailey, 1983] 
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During the early years of 
Defensive 
computers in the 1950s, the Programming 


| \ Effective 
standard approach to making Documentation 
computer systems \ 


understandable was the users’ 





own trial and error. Barly PAciag 
users would have to try one User Trial va 
and Error 
rocedure after another, - : 
P Figure 2 Historical trend in 
realizing what was the right iis aoe t 1 i 1 aes ee oT 
Piece Lyqibwlrey. 


approach and what was the 

wrong one by seeing how many vacuum tubes were blown because 
of different actions. Intelligibility was instilled in 
computer systems later by phone call support, training, and 
effective documentation. The future of computers is 
represented by "defensive programming," which means 
anticipating problems and coding to avoid errors before they 
arise. It includes such techniques as windows-icons-mouses- 


and-pointers (WIMP). (Brockmann, 1990] 


B. RHETORICAL ORIENTATION IN THE WRITING PROCESS 
Communication takes place in a context called the 
rhetorical situation, which includes an encoder (writer) and 
a decoder (reader or user), each having a purpose for reading 
or writing. Communication is effective when the message 


received by the decoder is nearly the same as the message sent 


Vs 


by the encoder. [Pesante, 1991] Rhetorical orientation 
includes such factors as [Sullivan and Porter, 1990]: 

e the writer’s model of communication--that is, the writer’s 
beliefs about the way discourse works, the way it ought to 
be produced, and the way users ought to respond to it. 

e the writer’s beliefs about priorities in writing--what are 
important criteria and how do we measure writing 


effectiveness? 


e the writer’s attitudes toward authority--where will we 
look for answers? what authorities should we call upon? 


*e the writer’s conviction to a specific document--to what 
degree is the writer an advocate for the document? for the 
system? for the user? 

"Noise" that prevents effective communication includes 
ambiguity, mistaken assumptions, emotional reactions to a 
topic or word choice, insensitivity of the writer to the needs 
of the reader/user, overuse of passive voice, long, convoluted 
sentences, and so on. To be effective, a writer must analyze 
all the elements of the rhetorical situation and the 
relationships among them: reader/user(s), writer(s), subject 
matter, and language. It is especially easy in technical 
writing to concentrate on the subject matter and neglect the 
other elements. [Pesante, 1991] 

Studies have shown that a writer’s use of information is 
guided by that writer’s rhetorical orientation, particularly 
his/her view of the audience/user. [Sullivan and Porter, 
1 OF From the perspective of theories of writing and 
rhetoric, user-centeredness has a solid basis in historical 


precedent. Rhetoricians have always been concerned with the 
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importance of occasion in 
USER(S) 


defining the purposes or aims 


of a piece of communication. 


Placing the audience at the 
DESIGN 


center Of discourse Ge Ale 


production has also been a 


significant feature Ot 


WRITER(S) TASK/ACTION 





rhetoric and writing study, Figure 3. The Communication 


tae Triangle of a User- 
so user analysis is a logical PonboDedeRicLoric 


extension of this research. 

Modern composition theorists have drawn upon the traditional 
communication triangle of encoder/decoder/reality to give a 
conceptual image to the writer/reader/subject triangle. The 
rhetorical framework of user-centered documentation is 
reconstructed in Figure 3, to give a clear, conceptual view of 
the parameters of the discursive territory in question. 


[Johnson, 1990] 


C. SOFTWARE USER DOCUMENTATION PURPOSES 

Some of the specific purposes of user documentation are to 
improve efficiency, to overcome users’ fears of equipment or 
software, and to sell the product. 

People need to understand the systems with which they are 
working. During usability testing of a desktop publishing 
tutorial, the documentation writer discovered that persistent 


problems users had with the tutorial were tied to conceptual 


by 


issues. His verbal explanations to the users of how the 
software program works and how it differs from word 
processing, as well as his description of the systematic 
operation of the computer system on which the users were 
working, generated interest in the users and resolved some of 
their problems. [Sullivan and Porter, 1990] 

When users of new software confront a complicated and 
poorly-organized set of reference manuals as their 
introduction to a piece of software, they are apt to regret 
their introduction. On the other hand, if they see a 
Simplified tutorial for the same software, they are more 
likely to forge ahead. [Brockmann, 1990] The tutorial on 
desktop publishing mentioned previously was developed as a 
lock-step, directional guide which maintained a consistent 
tone, style, and design throughout. Users praised the 
Simplicity and Rirecoue approach, particularly early on when 
they were least confident. Eighty percent of the users 
reported feeling good about what they had learned about the 
software program, indicating that they felt confident enough 
to try the program on their own in the future. [Sullivan and 
Porter, 1990] Successful software documentation, then, leads 
to successful first encounters with software and hence to 
greater acceptance and uSe. [Brockmann, 1990] 

Most people agree that the quality of documentation for 
the end-user can make the difference between success and 


failure for a new software product. The manuals are what the 
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customer sees first and therefore they shape the perception of 
the entire package. (Brockmann, 1990] Also, research 
indicates that documentation is the most important potential 
point of difference between software producers. When software 
products are perceived as fairly difficult to use, 
documentation can change customers’ minds or not. "User 
friendly documentation shows off user friendly software; 
together, they win customers and customer loyalty." [Borland, 


1984) 


D. TYPES OF SOFTWARE USER DOCUMENTATION 


User documentation can be classified in two ways: First, 


it can be classified by content --reference material and 
tutorial material-- and second, by environment --external 
documentation and internal documentation. Knowing the 


different types of documentation will help to make decisions 
on what to include in a documentation package in response to 
the audience and the software. (Brockmann, 1990] 

Reference material is technical, detailed, comprehensive, 
and usually organized like an encyclopedia or dictionary for 
quick retrieval of information. A reference manual should 
explain what the software can do for the user rather than 
comprehensively describing the product. An emphasis on 
product capability in a reference manual allows the user to go 
beyond the necessarily constrained steps of a tutorial, and 


combine product features in creative ways. The emphasis of 


i 


the former is on product capability as opposed to an emphasis 
on product internal construction, as with the latter. 
(Brockmann, 1990} 

Tutorial material selects from the comprehensive reference 
material and presents information in a step-by-step fashion. 
It is usually organized around user tasks or a hierarchy of 
user needs. [Brockmann, 1990] 

A 15-year survey of users carried out by Control Data 
Corporation, Scientific Data Systems, and Xerox Data Systems 
resulted in two apparently contradictory findings. Half the 
users thought manuals had too little detail, and half thought 
they had too much detail. Two-part manuals, with a tutorial 
and a reference section, were suggested as a compromise by the 
survey takers. By clearly segmenting the manual in two parts, 
the user can choose the coverage of material appropriate for 
his/her particular situation. [Brockmann, 1990] Borland 
described much diversity in views of documentation between 
users with little computer experience and programmers with up 
to twelve years experience. Borland’s "solution manual" was 
one with a tutorial, a reference, and a "cookbook" (filled 
with "recipes" to accomplish tasks and procedures for using 
illustrations, both of the steps and of the result). 
(Borland, 1984] 

Selection of material coverage for a software manual 
should also be influenced by the "open-endedness" (how much it 


can be customized, used, and viewed in different ways) of the 


20 


software to the user. General database development packages, 
for example, are open-ended to a greater extent than a spell- 
checker; thus, the material in the database manual would 
probably be presented as a reference manual. In a software 
package which can be viewed or used in only one way, such as 
the spell-checker software, the more appropriate manual 
presentation would likely be a tutorial. This is especially 
true since tutorials tend to limit the users’ conceptions of 
the uses of the software because of the specificity of 
directions and examples. This may not be desirable for open- 
ended software packages. 

External documentation is meant for audiences outside the 
corporate or organizational environment in which’ the 
documentation is developed. It is usually a more expensive, 
professional product, being a marketing tool as well as an 
operations tool. It is usually attractively packaged and 
filled with graphics. [Brockmann, 1990] 

Internal documentation is developed by an organization to 
be used by people within that same organization. It makes up 
the bulk of all documentation, yet it frequently fails to 
receive the necessary time, money, and attention because it is 
used only inside an organization and is not part of a product 
to be marketed. Thus, it is not directly related to profit 
making. Also, internal documentation is not as well designed 
as external documentation because the writers usually do not 


seek or receive as much feedback. [Brockmann, 1990] However, 
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an internal manual that is targeted to a specific audience 
could be superior to a generalized external manual with 


respect to relevance, simplicity, and brevity. 


E. PROBLEMS WITH SOFTWARE USER DOCUMENTATION 

There can be many problems with documentation that render 
it inadequate or ineffective. Some examples of problems are 
(Brockmann, 1990]: 


e Layout and Style Problems: misprints, use of ordinary 
prose, overuse or underuse of paragraph numbering, lack of 
or poor highlighting scheme, style that is not conducive 
to skimming and scanning 


e Organizational Problems: not organized to aid the 
reader’s search for information, no preface telling the 
who, what, and when behind the document, announced order 
of presentation of material not followed, order of 
material not intuitive, not apparent, or not supported by 
graphics, often-used commands not clearly separated, 
summary of procedures not clearly set out at the beginning 


e Audience Analysis Problems: important information missing 
or unimportant information cluttering explanations, lack 
of graphics, figures, and other supporting information 


¢ Consistency Problems: programs, commands, functions not 
having same name throughout, formats and layouts changing, 
phraseology and wording not staying the same as much as 
possible, numbering for sections and subsections not 
consistent, transitions from topic to topic or screen to 
screen not obvious 


e Poor Reference Aid Problems: lack of or incorrect table 
of contents or indexes, not enough level of detail in 
table of contents, illustrations, figures, and tables not 
numbered, titled, or listed 


¢ Update Problems: no plan for updating, handwritten notes 
used to update 


¢ Language Problems: words such as files and records used 
without explanation, no glossary, inappropriate words 
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used, words used interchangeably which do not mean the 
same thing, unclear or conflicting instructions 
F. CAUSES OF INADEQUATE SOFTWARE USER DOCUMENTATION 
Seven factors contribute to the problems causing the 
production of poor user documentation. 


e The change from centralization to decentralization of 
computer systems 


e Institutional limitations 
e Inadequate design documentation 
e The techniques used in user documentation 


e Oversimplifying the writing task in many how-to books and 
professional journals 


¢ Fighting against rather than harnessing the learning 
behaviors adults spontaneously adopt 


e Natural egoism 

Many writers have had difficulty adjusting to the change 
in the place and function of user documentation. In the 1950s 
through the early 1980s, computer systems were mostly 
centralized and surrounded by software specialists who could 
translate any user documentation that users did not 
understand. With the shift toward decentralization, where 
microcomputers and workstations stand alone throughout 
organizations and geographic locales, software specialists are 
not available to translate or train at each node. Thus, user 
documentation must also be able to stand alone. Too many 
writers continue writing in the centralized frame of mind. 


[Brockmann, 1990] 
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Even when documenters are alert to the needs of 
documentation in a decentralized environment, institutional 
factors may still prevent them from producing effective 
computer documentation. First, training and education are 
lacking in many organizations. Second, company standards 
which support and enhance good, effective documentation often 
do not exist. Similarly, if examples of documentation 
formally presented in standard development methodologies or 
informally circulated in an office are not examples of good 
documentation, training and official company standards may go 
for naught. Finally, good, effective technological support of 
the documentation effort enhances the likelihood of good 
documentation. The various iterations of a document should be 
completed as faultlessly and as quickly as possible. Speed of 
production is crucial because good documentation is the result 
of Continues ree ence The longer and more laborious the 
process, the less inclined documenters will be to redraft and 
rewrite. Hence, the more powerful the tools that are put in 
the hands of the documentation developers, the better the 
final document will be. Underlying these institutional 
factors are management support and encouragement. Good or bad 
documentation and the climate producing either are largely a 
function of management. [Brockmann, 1990] 

To write an effective piece of computer documentation, a 
writer needs full and complete information on the design of 


the system or the program. Without a solid foundation of 
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complete, clear, and accurately-written design documentation, 
user documentation writers must expend more time and effort in 
interviews with designers, making educated guesses, and 
repeatedly reviewing and rewriting. [Brockmann, 1990] 

The techniques required for writing user documentation 
differ radically from those required by essays or the like. 
The basic difference is that between arranging information for 
sequential access and arranging it for random access. 
Computer documentation must be able to be easily scanned and 
skimmed. [Brockmann, 1990] 

Oversimplification occurs when documentation writers turn 
for help to commercially published instructional texts which 
do not adequately alert them to the effects that audience 
variations have on documentation projects and products. As an 
example, the use of templates, in which writers needed only to 
fill in set templates with information peculiar to their own 
system, initially appeared to solve problems of content 
adequacy and of organization. As template use developed, 
however, it essentially confused sophisticated data processing 
users who had extensive prior knowledge with users who had no 
such knowledge and needed much more. (Brockmann, 1984] 
Today, new problems may be caused with the advent of industry- 
wide, corporate-endorsed, research-based guidelines and user 
interface standards. These standards may cause problems in 


four ways [Brockmann, 1990]: 
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e First, to be generally applicable, they often fail to be 
sufficiently specific to the users’ tasks 


e Second, they can foster a superficial consistency 
e Third, research data are currently too incomplete to 

Support all the rules in these standards and so "best 

guesses" are packaged indistinguishably with "soundly 

researched principles" 
¢ Fourth, and most important, guidelines, rules, and 

Standards invite documenters to forgo testing with real 

users. 

Some adults resist explicitly addressing themselves to new 
learning. Two paradoxes, motivation and assimilation, are 
described as explanation for this kind of behavior. The 
motivation paradox is the "production bias" people bring to 
the task of learning and using computers. The chief goal is 
throughput, reducing motivation to spend any time just 
learning about the system; so, when situations occur that 
could be more effectively handled by new procedures, people 
are likely to stick with those they already know regardless of 
their efficacy. The assimilation paradox is that people apply 
what they already know to interpret new situations. Though 
often helpful, irrelevant and misleading similarities between 
the new and old information can blind learners to what they 
are actually seeing and doing, leading them to draw erroneous 
conclusions or preventing them from recognizing possibilities 
for new functions. [Carroll and Rosson, 1987] In the design 


of documentation that takes the "systems" approach, which 


focuses on step-by-step procedures in which the reader is 
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expected to be passive and just follow along, these two 
paradoxes can become problematic. [Brockmann, 1990] 

Natural egoism is the final factor that can adversely 
affect documentation. A writer will not be effective until 
he/she is able to empathize with the readers and recognize 
that the readers approach software documentation with 
different backgrounds, expectations, training, and education. 


[Brockmann, 1990] 


G. SURVEY FINDINGS REGARDING PAPER DOCUMENTATION 
Table 1 summarizes the common recurring findings of the 


four marketing surveys described in this section. 


Major Consistent Xerox, AT&T | Microsoft PC-User 
Findings for Control : Group 
Paper Data, | (1986) (Borland, (Wilton, 
Documentation Scientific 1984) 1985) 

(Maynard, | 
1982) 


More task- 
ee 


More Dore futocsans im 


Improved 
reference aids 


ee a 


More 
illustrations 





Table 1. Recurring findings in user surveys of paper 
documentation 


The 15-year survey of users carried out by Xerox, Control 


Data, and Scientific Data Systems [Maynard, 1982] and a 
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parallel survey carried out with military users [Beard and 
Callamars, 1983] showed the major complaints to be: 


e Manuals were software-oriented rather than function- 
oriented 


¢ Manuals did not have enough examples 
e Manuals did not have enough reference aids 
An independent market research firm conducted an external 

documentation market survey for AT&T in 1986. The survey 
identified features of documentation that both users and 
dealers thought were important factors in selecting one 
software package over another. Major themes were that 
information in AT&T manuals should be: 

e Easy to find: better reference aids were recommended 


e Easy to understand: not assume too much, have graphics, 
and be task oriented 


e Complete, accurate, and current 


e Indexed: absence of an index was a definite reason to 
avoid purchasing a software product 


Microsoft Corporation conducted a documentation survey in 
1984 [Borland, 1984] which found that end users wanted: 
e task-oriented tutorials. 
¢ screen illustrations and terms explained in glossaries. 


e reference cards which listed first all the commands and 
then the tasks with commands used to complete them. 


e a feature-oriented/command index as well as a task- 
oriented index. 


* a task-oriented organization. 


e a reference manual that comprehensively described all the 
features of the product. 
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*e trouble-shooting guides. 
A PC User Group conducted a survey of 241 microcomputer 
owners [Wilton, 1985]. Table 2 portrays the contrast between 


what readers said they wanted and what was actually delivered. 


Do you agree or disagree? 


Manuals should accommodate all users 
Vs. 
Manuals do accommodate all users 


Tutorials are usually helpful 
vs. 
Many manuals omit tutorials 


Illustrations should substitute more 
for text 

vs. 
Illustrations are adequate in number 


Information is easy to find 
vs. 
Manuals bury important information 





Table 2. Contrast between what users want and what users 
get. 
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III. FUNCTIONAL ANALYSIS AND DESIGN 


A. COMPARISON OF USER DOCUMENTATION DEVELOPMENT PROCESSES 

The software user documentation development process is 
defined and executed differently, depending on where you are 
and who you talk to. There seem to be as many processes as 
there are organizations who develop software or authors who 
write about developing software. Three treatments of software 
user documentation development processes are presented by 
Brockmann [1990], Weiss [1985], and Williams and Beason 
(io Cw: 

Brockmann [1990] revised his original seven-step Standard 
Documentation Process (SDP) which came out in 1986 to 
accommodate the many developments in the area of user 
documentation. His nines Stee SDP version 2.0 now gives 
information on CASE tools, new programming technologies, 
research on layout, format, typography, and use of color, 
desktop and electronic publishing, new documentation 
databases, and the effects of new techniques, technologies, 
and ideas, such as team writing styles, document prototyping, 
minimalist design philosophy, hypertext, and mass storage 
devices like CD-ROM and magneto-optical storage. The SDP 
replicates many tried and tested procedures used by well- 


respected, successful documentation writers. Figure 4 and the 
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following list give an overview of what is involved in the 


SDE. [Brockmann, 1990] 


Developing the 
Document 
Specifications 


Drafting and Reviewing Field testing 
Editing the the 
Document 


“=> SDP 


aga el 


ecient 





Figure 4. The Standard Documentation Process (Version 2.0) 
{[Brockmann, 1990] 


* Step 1. Develop Documentation Specifications. In this 
first step, planning the documentation occurs in two 
passes. The first pass is the development of a Library 


Specification that contains a brief description of all the 
documents involved with a particular software program or 
system. This plan gives an opportunity to communicate the 
"big picture" of the whole writing project to management 
or clients. The second pass is the development of the 
Individual Document Specification. This second blueprint 
follows the Library Specification and communicates the 
specific plans for a single document to management, 
clients, and users. Eleven activities are involved in the 
creation of these blueprints: breaking down the 
documentation in the library by tasks, using minimalist 
design principles, planning for an audience, analyzing the 
purpose of the documentation, organizing the material, 
developing a product visualization, picking the 
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appropriate media, deciding on page format and layout, 
planning for updating, considering the competition, and 
estimating cost and time requirements. 


Step 2. Prototype the Specification. Since the ultimate 
test for paper or online documentation is usability, 
document designers should iteratively test their pages and 
screens with users. Prototyping is repeatedly done with 
a document as it is being developed, but it basically has 
four steps: prepare for the test, instruct the testers, 
run the test, and analyze and apply the results. The 
results of prototyping should give guidelines for depth of 
coverage, vocabulary, readability, and organization. 


Step 3. Draft the Document. Once the specifications have 
been created, approved, and tested, it is time to draft 
the document. Seven activities make up this step: 
overcoming internal and external writing blocks, using a 
writing style that is designed to match adult reading 
behaviors, using reader-based writing techniques, 
developing effective graphics, creating reference aids, 
developing the documentation packaging, and planning for 
updates. 


Step 4. Edit the Document. Now that the document is 
drafted, it is revised so that it effectively and 
efficiently gets its message across. This is primarily 
accomplished by using levels-of-edit techniques. 


Step 5. Review the Document. Once the document is 
Grafted and edited, it is sent out for review. To have an 
effective review, carefully choose reviewers and the time 
to review, show reviewers how to review, and give them 
feedback. 


Step 6. Field Test the Document. A part of every 
document’s review should be a field test of a draft of the 
whole document. Where prototyping examined the pieces of 
a manual or online document during their creation and 
assembly, field testing examines how the document works as 
a whole. Accessibility, navigational problems, and 
consistency are primary areas of concern here. In 
conducting a field test, carefully choose field testers 
and the time to field test, run both an in-house 
"controlled" field test and an external field test, and 
provide feedback to field testers. 


Step 7. Produce and Distribute the Document. Once the 
document is drafted, revised, and reviewed, it is produced 
in a form suitable for distribution. With paper and 
online publishing mechanisms ranging so widely, and 
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multimedia publishing becoming more and more prevalent, 
preparing text via an SGML-like tagging system becomes 
essential. 


Tobep Oo. Review the Documentation Project. Once a 
document is complete, and before beginning a new project, 
analyze what went right and what went wrong during the 
process of developing the documentation SO that 
improvements to the process can be implemented during the 
next project, and mistakes and problems’ thereby 
alleviated. 


¢ Step 9. Maintain the Document. Even when the document is 
distributed, the task is still not completed because the 
document must be updated. To do this effectively, 
responsibility for updating a document should be clearly 
assigned. Distribution of the document should be tracked 
so that one knows where to send updates and the changes in 
the updates should be clearly indicated. 

Weiss [1985] describes five phases of user documentation 
in his Structured Process, all of which he believes necessary 
for effective, usable documentation. By structured, he refers 
to a formal, top-down decomposition of the user documentation 
development process into a development model which is designed 
so the components of the process are interconnected in the 
"best possible way." [Weiss, 1985] Figure 5 is a data flow 
diagram of the five phases, showing the development flow for 
user documentation. A brief description of the five phases of 
the Structured Process follows. 

e Phase 1. Analysis. Define just what manuals and other 
information products the users and operators need. The 
earlier in the life of the system the analysis takes 
place, the better. Ideally, the documentation analysis, 
which often culminates in a Publications Plan in large 
projects, should occur as part of the original system 
development plan, but it is never too late to analyze the 
remaining documentation need. 

e Phase 2. Design. Prepare detailed outlines of each 


manual or other information product. This phase starts 


So 





Figure 5. Data Flow Diagram for 
Developing User Documentation using 
A Structured Process. [Weiss, 1985] 


¢e* with the preparing of conventional outlines, but then 
proceeds to the creation of "structured outlines" and 
"storyboards" -- working models of the documents that can 
be tested and revised before the first draft is written. 
The most difficult structural and organizational problems 
must be corrected before the first draft is written. 


e Phase 3. Assembly. Convert the storyboard to a work plan 
and write the first draft. In the structured approach to 
documentation, writing the first draft is a little like 
writing the code in a structured program: that is, the 
writers do little more than fill in missing details, 
according to a strictly-followed plan, the "storyboard." 


e Phase 4. Editing. Test the first draft for clarity, 
correctness, and readability. In this approach, questions 
of language and style are more than matters of esthetics; 
rather, the purpose of this phase is to apply principles 
of editing that make the manual easier to use, and 
therefore less likely to cause a "failure" (defined as 
what occurs when an operator or reader us unable to work 


the system because of a bug in the manual). In many 
cases, this phase culminates in a test with "live" 
readers. 


e Phase 5. Maintenance. Track what needs to be changed in 
the information products and, when appropriate, make the 
changes. Because all manuals are flawed or out-of-date 
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(without exception, according to Weiss), the last phase of 
documentation is to monitor what should be added, removed, 
replaced, or repaired. The craft of maintaining user 
documents is knowing what changes must be made and being 
able to distribute and incorporate those changes in a 
manner that does not generate confusion and additional 
errors. 


Williams and Beason [1991] view software development 


projects as having nine phases. These nine phases somewhat 


Table 3. User Documentation in the Software Development 


2 Requi 
Alte 
Analy 


Process. [Williams and Beason, 1991] 


Phase User Documentation 


1 Feasibility 


Analysis 


renents | 
Definition 


3 rnatives 
sis 
4 Functional 
Specifications 
5 Preliminary Documentation plan 
Design 





6 Detailed Design Outline(s) for user documentation 


and Construction 
First draft(s) of users’ manual (s) 


First draft(s) of online help systen 


7 Verification . Reviews of first drafts 


(alpha and beta 
tests) Usability tests of tutorials and procedures 


guides 
| Review, linking, and testing of online systems 
| Final draft(s) of users’ manual (s) 


| Wirst and final drafts of quick reference pieces 


8 Implementation User documentation completed 


9 Maintenance Revisions and addenda 


correlate with the seven phases of the Standard Software 


Development process from the IEEE Software Engineering 


So 


Standards reference [1990]: Concept, Requirements, Design, 
Implementation, Testing, Installation and Checkout, and 
Operation and Maintenance. According to Williams and Beason, 
the user documentation development process begins during phase 
five of a software development project and continues 
throughout the remainder of the life cycle of the project. 
Table 3 shows how Williams and Beason [1991] believe user 
documentation fits into the overall software development 
process. As you can see, their Documentation Development 
Process generally comprises five phases, as follows: 


e Phase I. Documentation Planning. Locate and review 
existing information and confer with team members. Decide 
how many and what types of individual documents (manuals 
or other printed pieces) and online materials are needed. 
Decide on the goals of the documents. Write a profile of 
the audience. Determine production methods, including the 
means for creating illustrations, producing a final draft, 
and reproducing or printing the required number of copies. 
Describe the physical appearance of the document, put the 
plan on paper, and get it approved. Draft a schedule and 
get it approved. Create a style guide. 


e Phase II. Outlining and First Drafts. Review information 
in the documentation plan about readers and their needs, 
and the goals of the document. Decide how to organize the 
document. Draft a preliminary or working outline of the 
printed documents, including quick reference materials. 
Draft a preliminary outline of the online materials. 
Review the outlines and revise them if necessary. Get the 
outlines approved. Write the first draft. Write or 
review the first draft of the online materials. Make a 
preliminary list of illustrations. Read and revise the 
first draft. Update the list of illustrations. Send the 
draft out for review. 


e Phase III. Subsequent Drafts, Usability Testing, Final 
Drafts. Incorporate comments and corrections from the 
review. Do any necessary rewriting. Make copies of 
completed illustrations and insert them in the draft. 
Proofread and correct the draft, covering both text and 
illustrations. Send the draft out for review. Review and 
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correct online materials. Senduce™usabmaty tests of 
tutorials and procedures guides. Review, link and test 
online systems. Incorporate comments and corrections from 
the prior review of drafts. Read all text and review 
illustrations, checking fOr flow, efaricy, and 
completeness. Write quick reference materials. Get final 
okays on changes from reviewers. Have quick reference 
materials reviewed and proofread. Check text and 
illustrations for Consistency, and proofread for 
typographical, spelling, or placement errors. Indicate 
spaces for illustrations. If necessary, mark headings, 
words, or phrases that need special emphasis, and page 
breaks. Review online materials for the final time. 
Correct quick reference materials. 


¢ Phase IV. Production. Produce the text by typewriter, 
word processing software, or computerized typesetting. 


Proofread the text. Make up pages, merging text and 
graphics. Check for continuity and positioning of 
illustrations. Number the pages of the document if 
needed. Prepare the table of contents and index. 
Proofread page numbers for the index and table of 
contents. If the document is being professionally 


printed, check the blue line (sample of printed document) 
for accuracy, consistency, and placement of text on pages. 
Print or duplicate the required number of copies. 
Assemble, bind, and distribute documents. 


e Phase V. Maintenance. Prepare, incorporate, and 
distribute revisions and addenda on an ongoing basis as 
necessary. 


Although the number and definitions of the phases and 
steps in each of these processes vary, all have commonalities 
which must be viewed as mandatory in any software user 
documentation development process. A comparison of the three 
approaches to the documentation process is provided in Table 
4. However the steps or phases are organized, the actual 
processes all contain the elements of planning, designing, 
Grabeine, rewriting’ testing, producing, distributing and 


maintaining the software user documentation developed. 


ow 


Table 4. Comparison of Software User Documentation 
Development Processes. 


SDP [Brochkmann, 1990] Structured Process Document Development 
(Weiss, 1985] Process (Williams & Beason, 
1991) 


1. Doc Specs 7 Analysis I. Documentation 


plan 
| 2. Prototype II. Design 


3. Draft Doc III. Assembly II. Outline & First Draft (s) 


4. Edit IV. Editing III. Reviews, Tests, Final 
Drafts 

6. ield test 

7. Produce/Distro IV. Production 


8. Review Project ; V. Maintenance V. Maintenance 





Since the development methods studied displayed 
commonality, the decision on which method to use _ for 
development of the user’s guides for the AS/IS Computer Labs 
at NPS was based on versatility, applicability, complexity, 
completeness, and currency of the method. This researcher was 
looking for a method which has the following attributes: 1) 
versatile enough that it could apply across most development 
Situations; 2) easy to understand; 3) speedy assimilation; 4) 
sufficiently complete; and 5) applicable to military graduate 
students. Also, this researcher desired a method which had 
been developed or updated within the last couple of years so 
that its techniques would incorporate industry advancements 
and evolutions. For these reasons, a combination of the SDP 


formulated by R. John Brockmann [1990] and the Documentation 


Sie 


Development Process formulated by Williams and Beason [1991] 
were selected as the guides for creating the user’s guides 


contained in the appendixes of this paper. 


B. COMPARISON OF SCREEN AND CATEGORIES OF PRINT DESIGN 

The content-classified types of software documentation 
(reference and tutorial) discussed in Chapter 2 can be further 
categorized into five basic classifications [Williams and 
Beason, 1991]: 


e Tiueoxr 1 alee Teaches basic program functions through 
controlled "lock-step" practice sessions 


e Procedures guide: Explains and gives’ step-by-step 
instructions about how to perform all the functions of the 
program 

e Reference material: Describes in detail commands, 


functions, fields, key assignments, and/or messages 

e Quick reference piece: Lists the most frequently used 
commands, functions, or key assignments (may be a card, 
keyboard template, small guide booklet, or single-page 
document) 


e Online help system: Displays information on the screen 
while the program is running 


The following chart aids selection decisions with regard 
to the categories of documentation to produce [Williams and 


Beason, 1991]: 
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TYPES 


TuUEOriIaL 


Procedures guide 


Re fierence 
material 


Quick reference 


piece 


Online help 
system 


USE WHEN 
Users are novices 


Users must teach 
themselves 


Users need to get 
started quickly 


Program 1s 
complex or 
interface is 
intimidating 


Users have some 
experience or 
program is simple 


Users know how to 
use features and 
are familiar with 
the interface 


Ussteeres are 
experienced with 
the program 


Users need 
information while 
nablig igh ak g\ (cy the 
program 
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ADVANTAGES 


Builds confidence 


Lets users 
practice 
Allows CQunci, 
user-friendly use 
of pO Gt am 
features 


Allows users to 
choose only 
procedures they 
need 


Information is 
Cc oO mM@p 1 ee t ec 
arranged in task- 
omrnmm™ en t ed 
groupings 


Allows quiere 
access to details 


Allows users to 
ap puro a CeR 
information from 
many angles 


Quickly reminds 
users which 
com M a ned sey 
functions, or 
keys to use 


Allows users to 
get assistance 
without looking 
away from the 
screen 


The decision about which categories of documentation to 
produce depends on the needs of the audience and on the budget 
and schedule. For documenting only an application, a 
procedures guide may be sufficient; for documenting a 
programming language, a reference manual may be adequate. 
Generally speaking, no one category of documentation can 
please all types of users. [Williams and Beason, 1991] For 
the purposes of this study, task-oriented procedures guides, 
also called a user’s guides, were selected for production, 
based on the audience analysis and limited budget and 
schedule, and because effective, complete online documentation 
was already available via the online HELP features offered by 


both WordPerfect 5.1 and dBase IV 1.1. 


C. DESIGN ISSUES 

Normally, the first exposure a new user will have to a 
system is through user’s manuals. Careful planning must be 
devoted to the design of documentation since inadequate design 
results in end-user dissatisfaction. Readers only use 
documentation to get their job completed when it requires some 
kind of computer assistance. Thus, the best design for 
software documentation is the one that fits the users’ methods 
of working and requires the least attention and learning. 

In designing the user’s guides for the AS/IS Computer 
Labs, the researcher focused on organization, content, layout, 


and language. It is thought that these elements are the four 
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factors “that Wmose impact the effectiveness of the 
documentation design. [Gleason, 1986] 
1. Organization 

Widely used in the industry until recently, a software- 
internals orientation approach to documentation design 
concentrated on the structure and facilities of a program 
rather than on the user’s use of that program. This approach 
received extensive criticism in the 15-year survey of users 
carried by Xerox, Scientific Data, and Control Data 
corporations. Users almost always preferred task-oriented 
manuals because a software-internals orientation forces users 
to center their business duties around the software rather 
than vice versa and because users must know the structure of 
the software before being able to use the documentation. 
(Maynard, 1982] On the other hand, a task orientation is 
based on an analysis orrene user’s use of the program and is 
limited to what information is required to do a specific task 
using the program. Thus, the focus is turned from the system 
to the users using the system in their daily work. 
[Brockmann, 1990] "Having the user at the center...allows for 
concentrated efforts from diverse fields toward a common goal: 
the development of usable documents for whatever medium may 
come our way." fJohnson, 1990] 

The IEEE Standard for Software User Documentation [IEEE 


Std 1063-198), 1958 }estacesathar, 
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"Users of software need documents either to learn about 
the software (instructional mode) or to refresh their 
memory about it (reference mode). Instructional mode 
documents may be either information- or task-oriented. 
Information-oriented documents give the reader information 
needed to understand the computer software and its 
functions; task-oriented documents show the reader how to 
complete a task or reach a goal." 
The end products of this paper, two applications user’s 
guides, are more for reference than instruction, but contain 
some general information about the application software and 
Lts fumct pons The primary purpose of each was to guide 
certain NPS students on their own or, if desired, as a 
supplement to instructional courses, through the basic 
procedures of word processing (in the case of WordPerfect 5.1) 
and working with a database management system (in the case of 
dBase IV 1.1). Thus, a task-oriented approach was adopted. 

A task orientation, in which the designer selects 
content and employs an organization appropriate to a user’s 
work needs, points to use of the minimalist design philosophy. 
The goal of a minimalist design philosophy is to present 
material appropriately to the actual ways adult learners learn 
rather than fighting against their natural tendencies the way 
a "systems" (e.g., software-internals) design philosophy does. 


{[Brockmann, 1990] Research has verified that adult learners: 


e Are impatient learners and want to get started quickly on 
something productive 


e Skip around in manuals and online documents and rar2ly 
read them fully 


e Make mistakes but learn most often from correcting such 
mistakes 
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e Are best motivated by self-initiated exploration 


e Are discouraged, not empowered, by large manuals with each 
task decomposed into "irritating" subtask detail 


The key idea is to present the smallest possible obstacle to 
learners’ efforts by providing less overt training structure. 
[Carroll, 1990] The minimalist design tips used in creating 
the user’s guides in Appendix B and C include [Brockmann, 
TOON: 


e Minimize secondary features of manuals and online 
documents (overviews, introductions, summaries, etc.). 


°e Focus on what readers need to know to immediately apply it 
to productive work. 


e Make it easy for the reader of a page to coordinate the 
documentation with the screen information by grouping 
instructions and cursor movement/navigation key tables 
together by the screen to which they apply 


e Use what the readers already know by continuously linking 
new information to it 


The DDP exhorts designers to organize the guide and 
group procedures to reflect the way users will use the 
program, such as listing the procedures for entering 
information before listing the procedures for editing that 
information. Additionally, designers should include all the 
information needed to successfully complete each procedure. 
Additionally, each procedure module should be organized 
internally, so the modules will be consistent. [Williams and 
Beason, 1991] In the user’s guides appended to this paper, 


for example, each procedure module contains a heading (name of 
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procedure), brief introductory paragraph, and numbered steps 
of the procedure. 

Brockmann [1990] lists two primary principles of 
organization, both of which were followed in organizing the 
text material in the appended user’s guides. 

e Make the organization of material apparent to readers. 
Essentially, that means that with words, graphics, or 
layout, "Tell the folks what you’re going to tell ‘’em 
before you tell ‘’em." 

¢ Organize documentation in ways expected by the readers. 
Using general-to-specific and explanation-to-specific 
conditions works effectively; that is, instructions state 
a general procedure which is applied to the specific 
context. Also, readers expect information to be presented 
in chronological order, most-important-to-least-important 
order, order of need, and order of difficultly. 

The length of a user’s guide varies depending on the 
subject matter. This researcher tried to limit the 
WordPerfect guide to fifteen pages of material, which would 
adequately cover all basic functions to be performed by the 
target audience. Since a database management software program 
is generally so much more complex than a word processing 


program, the dBase IV guide required approximately thirty 


pages to adequately cover the material needed by the target 


users. 
2 .wCont ert 
The content is the part of the manual that describes 
operations. It focuses on commonly-used tasks and its 


productivity is measured in terms of relevancy to the user. 


The key to selection of tasks to be covered was the "80-20 
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Rule." The 80-20 Rule is that the user’s guide should cover 
the 20% of the tasks that are used 80% of the time. 

An overview of the project also helps define what 
information should be included. Elements that should be 
considered are [Williams and Beason, 1991]: 

e General purpose of the project 
e Intended users of the software 
e Features of the software 


e Features that are outstanding or that make it different 
from other similar software 


¢ Operating system and other related software 

e Computer and other related hardware 

e Network or larger system the software may be part of 
Only the content that the user needs should be included. The 
manual should be as brief as possible, but not at the 
Sacrifice of pertinent information. 

3. Layout 
A good layout can make a manual more readable and give 

the writer the means for presenting information clearly and 
cleanly. A layout for a software manual must meet two goals: 
to make it easy for users to absorb information on the first 
reading and easy for them to locate specific bits of 
information later when they may need them. Generally, to 
design a manual which meets both these requirements, the 


writer must [Williams and Beason, 1991]: 
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e Format the separate elements consistently so the readers 
can identify them at a glance. All procedures should look 
alike. 

e Use a generous amount of white space (blank space) on the 
page. Information stands out on a page with white space 
and the pages are less tiring to read. 

e Use headings to show the structure and hierarchy of the 
information. Format them so they stand out from the text 
and so the subordination is clear. 


e Make columns of text no wider than 65 to 70 characters per 
line (4-5 inches). Wider lines of type are hard to read. 


Documents are usually made up of three major sections: 
the front matter, the main text, and the back matter. The 
front matter includes all or some of the following: title 
page, copyright or acknowledgements page, table of contents, 
list of figures and/or tables, symbols and conventions page, 
and installation and start-up guidelines. The main text is 
the introduction and main body of the document. The back 
matter contains any appendixes needed, a glossary, and an 
index. [Williams and Beason, 1991] For simple, in-house 
documents, such as those created for this study, only the 
parts considered absolutely essential are included. 

4. Language 

If you want users to get the most out of the program, 
use language that is clear, strong, and direct. Williams and 
Beason [1991] and Brockmann [1991] provide many guidelines 


which were considered when formulating the user’s guides: 


e Use nonsexist' language: Use generic titles and 
descriptions (e.g., chair instead of chairman) and 
nonsexist pronouns and adjectives. Some techniques to 


help include addressing readers directly (e.g., You can... 
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instead of He can...); use the plural form rather than the 
Singular (e.g., programmers keep their disks... instead of 
a programmer keeps his disk...); if the title must be 
Singular, substitute an article (a, an, the) for a pronoun 
(e.g., the operator enters a password rather than the 
operator enters his password); repeat the title of a 
person rather than using a pronoun; if there’s no other 
way, use he/she or him/her. 


¢e Use plain language: Use short sentences predominantly and 
plain one- and two-syllable words whenever possible. 


* Eliminate unnecessary words: Avoid noun clusters (use 
classroom instead of structured learning environment) ; 
avoid prepositional phrases (use because instead of as a 
result of); avoid redundancies (use repeat instead of 
repeat again); avoid wordy phrases (use truth instead of 
plain, unvarnished truth). 
e Use active verbs: Active verbs make your style forceful 
and direct; passive verbs weaken your language and makes 
it seem vague and lacking in authority. 
e Choose the proper tense: Use the present tense most of 
the time; it’s easy to try to use the future tense, which 
weakens your writing (e.g., To write a program... instead 
of If you’re going to write a program...). 
D. AUDIENCE ANALYSIS 

The IEEE Standard for Software User Documentation [IEEE 
Std 1063-1987, 1988] prescribes that a software user document 
shall be keyed to its audience because the identified audience 
dictates the document presentation style and level of detail. 
The intended audience is to be identified and the different 
ways the users interact with software are to be considered 
when preparing user documents. 


Williams and Beason [1991] offered an audience profile 


description list which was useful in analyzing the anticipated 
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users of the user’s guides being prepared for this study. The 
elements included were: 


e Level of computer expertise: The range for this audience 
varied immensely, with experience extending from the 
novice to the dedicated computer user to those with both 
job experience and baccalaureate degrees in the computer 
field. Few are expected to have had experience on a 
network. 


¢e Occupation: Students in the AS Department at the Naval 
Postgraduate School who are pursuing advanced degrees in 
the administrative, managerial science, or information 
systems area. Most have been trained in some technical or 
managerial field in which they have been working for a 
number of years. 


¢ Knowledge about the field and subject: Although many have 
at least an idea of what word processing is about and have 
even used such programs previously, most potential users 
of the guide are presumed to have little experience with 
WordPerfect 5.1. Most potential users have not had any 
experience with a database management system _ or, 
specifically, dBase IV 1.1. 


e Position in organization or field: The prospective 
audience is students and faculty at an academic 
institution (NPS). 


e Level of education: The prospective users have at least 
a baccalaureate degree. 


e Age group: The students who will use the guides are older 
than average for graduate students, but a variation in age 
from mid-twenties to mid-forties is expected. 


e Reasons for using the program: Students are expected to 
use the WordPerfect program to create reports and research 
papers; in some cases, to complete an introductory course 
in WordPerfect 5.1; and to use the program in a variety of 
courses. They are expected to use dBase IV _ for 
introductory courses in database management and dBase IV. 
As the students progress in their curriculums and become 


more familiar with the applications programs, especially 


WordPerfect, they will "grow" from novice (or wherever they 
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Started on the scale of experience with the programs) to 
intermediate users who then become experienced users and so 
on. Thus, what pleases them in the beginning may not always 
please them six months down the road. Also, as they progress, 
the more experienced users are graduating and leaving, and new 
students are arriving. Thus, a varied audience is guaranteed. 
No single user’s guide will be able to fill every student’s 


needs. 
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IV. THE SOFTWARE USER DOCUMENTATION TEST PLAN 


A. TEST PURPOSE 

The best type of review of a user manual comes from the 
users themselves. This step is referred to as field testing 
by Brockmann [1990] and usability testing by Williams and 
Beason [1991]. In field or usability testing, the users of 
the documentation try using a document to see if it is 
effective and can stand alone. Testing helps provide 
information on how to improve the document before it is 
completed. Changes can then be made and the guide retested 
before the completed version is released. This has long been 


a standard method of testing computer systems and programs. 


B. TEST OBJECTIVES 

The main objective is to identify problem areas in the 
manual while it is still in the development stage. Usability 
testing is designed to help find problems in the manual’s 
wording, flow, and layout. It should indicate whether the 
writing style used in the manual can be understood by the 
intended audience, help identify steps that may have been 
inadvertently left out, and point out descriptions that do not 
match tasks. The testing can also provide information from 
test subjects on what areas they would like to see covered in 


the guide. 
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TEST PLAN 


This researcher followed six steps in planning the 


usability test [Williams and Beason, 1991] and [Brockmann, 


1990]: 


Step 1. Find volunteers who match your audience profile. 
If this is not possible, simulation of a typical audience 
1s acceptable. 


Step 2. Write an instruction sheet, listing simple tasks 
for the testing subjects to perform; the tasks should use 
basic and representative functions of the software. 


Step 3. Decide on a reasonable length of time to give the 
volunteers to complete each exercise. 


Step 4. Choose observers and brief them about your test 
purpose, their role, and so on. 


Step 5. Make arrangements for the use of work areas for 
the day of the usability test. Make sure they’1ll be 
properly equipped, not only with the relevant computer and 
software but also with adequate lighting and desktop or 
table space. 


Step 6. Prepare copies of the documentation that include 
a table of contents and an index. 


After the test, results should be compared among the test 


administrator and observers to see which areas consistently 


caused confusion among the volunteers and which areas caused 


the greatest degree of frustration. 


D. TEST ADMINISTRATION AND PROCEDURES 
The tests were carried out using the preceding plan, as 
follows: 


e Step 1. A total of seven NPS students were used to test 


the documents. They were tested individually or in a 
group of three. 


a2 


the 


Step 2. For the WordPerfect guide, a short letter was 
invented for the testing subjects to type in a document, 
Save, retrieve, and print. For the dBase IV guide, a 
short database of names, addresses, and phone numbers was 
provided so the subjects could build a database structure, 
index it by last name, query it, and generate a quick 
report. 


Step 3. The WordPerfect test was expected to take 
approximately one hour and the dBase IV test twice that. 
In fact, the WordPerfect test required one hour and ten 
minutes while the dBase IV test was completed in one hour 
and forty-five minutes. 


Step 4. One observer was used. This observer was an NPS 
student who served as a network laboratory assistant for 
the AS/IS Computer Labs and who also wrote a software user 
document for one of the applications installed on the 
AS/IS networks. 


Step 5. The tests were conducted in one of the AS/IS 
Computer Labs, on the Token Ring network in I-224. All 
resources needed for the testing (computers, printers, 
programs, desks, etc.) were already set up. The tests 
were conducted on two consecutive weekends when the labs 
were available and mostly empty. 


Step 6. Sufficient copies of the user’s guides were 
available for each testing subject. 

RESULTS AND FINDINGS 

The results of the usability tests focused primarily on 


user’s guides’ usefulness, success, and shortcomings. The 


primary benefit of the tests were in the improvements to the 


document. Participants identified the following types of 


e€Trors.: 


typographical errors 
factual mistakes 


confusing layout and format 
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Improvements to the manual were indeed beneficial. The tests 
helped to refine the design of poorly composed sections of the 
user’s guides. After observing the subjects and receiving 
their remarks upon completion of each of the tests, the guides 
were corrected and reformatted. 

The information gathered as a result of the testing does 
not signify conclusive results due to "lack of rigor of the 
test methodology." [Zirinsky, 1986] However, the information 
was extremely useful in guiding the revision of the document 
design. The user’s guides presented in Appendixes B and C are 
only prototypes and can be further refined, but can be used 
not to communicate with users at most levels of the audience 
continuum. Expert users of WordPerfect and dBase IV would 


probably find the user’s guides least useful. 
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V. CONCLUSION 

In concluding the results of this study, it appears that 
this researcher’s intention to create user-friendly user’s 
guides was achieved. The iterative methodology of the project 
development allowed the evaluation and refinement process to 
uncover errors and unclear sections. Changes were made that 
improved the manuals and helped make them viable tools for 
teaching and for reference. 

The emphasis shifted during the study from creating guides 
that the writer thought was relevant, to creating a guide that 
revolved around user tasks. Successful documentation requires 
an ongoing dialogue between the documentation developer and 
the users. 

Much of the difficulty people experience in learning a new 
computer system can be directly attributable to poor design. 
The egocentric style of designers must yield to humility, and 
designs adjusted to accommodate the users’ skills, desires, 
and orientation. [Schneiderman, 1986] Designers need to 
understand that their design efforts may not always produce 
the desired effects for a particular audience, and be flexible 
enough to accept redesigning a system when necessary. The 
techniques for producing quality documentation will be of no 


use unless audience analysis is given high priority. 


ae, 


The ultimate test of the user’s guides will be in the 
computer labs themselves and the classes in which they will be 
used. Refinements may still be required, corrections may have 
to be made, and more material may have to be added. 
Additionally, no computer program remains static for long, and 
trying to document the software has been likened to trying to 
change a tire on a speeding car. When new versions of the 
programs are released, new versions of the documentation will 
be required. To ensure consistency within the user’s guides 
appended to this paper and among any future user’s guides or 
lab manuals developed for the AS/IS Computer Labs, this 
researcher provided specifications, special graphics, and 
pertinent instructions with the AS/IS Computer Labs manager. 

In conclusion, it can be said that the principles 
described and the findings noted in this study can be used by 
all documentation writers to improve their documentation. The 
benefits gained from the testing and reviewing of software 
documentation is a better understanding of user capabilities 
and improvements in design strategy. With the goals of the 
user clearly in focus, the production of higher quality, 
useful documentation can be achieved. The ultimate result is, 
however, in the acceptance and use of the user’s guides by the 


people for whom it was designed. 
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APPENDIX A: AS/IS Computer Labs Software Directory 
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AS/IS COMPUTER LABS SOFTWARE DIRECTORY 


ROOM NUMBER: I-224 I-224 I-250 I-15 
NETWORK VENDOR & 
PROTOCOL: 


APPLICATION SOFTWARE Version 
Hayes SMARTCOM II 
SIMPC 

IBM PC 3270 Emulation 


WordPerfect 

WordPerfect 

WordPerfect 

PeachText 5000 

LOTUS 1-2-3 

STATGRAPHICS 

aBASE III+ 

GBASE Administrator 

GBASE IV 

GBASE IV 

INGRES /DBMS 

INGRES TUTOR 

EZ RATE Tariff 500-H 

Annualized Cost-of- 
Leaving Model (OSD) 

Universal Knowledge 
Management System 

IBM Storyboard Plus 

EtherMail 

EtherMenu 

Microtek Int’l EyeStar 

IBM Virus Scanning Pgm 

Polaroid Palette 
PSAVER 

Polaroid Palette for 
IBM PCs 

1DIR 

Force Analysis 
Simulation Model (FASM) 

Assembly 

BASIC 

C (Lattice) 

Turbo PASCAL 

Framework 

GRAMMATIK ITI 

Norton Utilities 





SYSTEM SOFTWARE 


IBM DOS 3.2 x 
IBM DOS 3.3 x x me 
IBM PC LAN O/S 1220 x x x 
3COM Etherseries 2oaa X 
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APPENDIX B: WordPerfect 5.1 Basic User’s Guide 
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ntroduction to Local Area Networks 


A local area network (LAN) is a group of microcomputers or other workstation devices located in the 
same general area and connected by acommon cable. A LAN is designed to interconnect microcomputers, 
terminals, minicomputers, and other hardware, for the purpose of communicating among themselves and 
alternately with a host mainframe computer or public network. 





The most common reason for developing a LAN is resource sharing. Networks allow the sharing of 
peripheral devices such as hard drives, printers, and scanners. Application programs such as spreadsheets, 
word processing, and communication packages can be shared so that multiple copies are not necessary. 
Databases can also be shared in such a way that multiple microcomputers can have access to a single 
database. This capacity for sharing hardware and software resources allows greater flexibility and cost 
savings in the use of expensive computer peripherals and software. 


The basic components of a LAN are the server computer, the user computer(s), and the interconnecting 
cabling system. The server is usually a microcomputer that is specifically designated to act as the network 
server. The server performs only those functions required of a network server; it can only be accessed by 
users through their user computers. Server functions include repository of software programs, network 
management, printer and other peripheral device management, and database repository. 


The user computer is normally a microcomputer or terminal, and is connected to the server by a cabling 
system. A simplified schematic of a typical connection is shown in Figure 1. One server can support more 
than one user computer, usually six to ten. The cabling system connecting the server and the users can be 


PHONE UNE 





USER PRINTER 


Figure 1: LAN Schematic 


present in a number of forms and configurations. Cabling can be twisted pair wire, coaxial cable, and fiber 
Optic cable. Configurations include bus, ring, and star. 
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Logging on to a LAN as a user gives access to all the software on the server. When a software package 
is chosen, a copy of the software is downloaded to the user computer for execution. The user computer 
executes the software like a standalone computer, not accessing the server again unless a peripheral device, 
such as a printer, is needed. Further information on these and other local area network topics can be found 
in the references listed below. 


ouggested References 


Berry, Paul, Operating the IBM PC Networks, Sybex, Inc., 1986. 


Fitzgerald, J., Business Data Communications, John Wiley and Sons, Inc., 1990. 





Madron, Thomas W., Local Area Networks: The Second Generation, John Wiley and Sons, 1988. 





Schatt, S., Understanding Local Area Networks, Howard W. Sams and Company, 1990. 
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This guide is primarily for those of you who are either new to WordPerfect and/or are new to working on 
a network and need to get WordPerfect running so you can create that first document. If you have used 
WordPerfect, or any other word processor, you are used to running the program from the subdirectory where 
the program files are stored. On a network the procedure is different. The program files are stored on the 
file server, where they are shared by other network users. If every network user stored document files in the 
WordPerfect subdirectory on the file server, it would be difficult to figure out which file belonged to which user 
and extremely difficult to locate files. Thus, users cannot edit, delete, or save files in the WordPerfect 
subdirectory; they need to save files to a floppy diskette. 


WordPerfect is a text-oriented word processor, which means that as you create and edit your document, 
it appears on your screen as ASCll-coded characters (to see your document as it will be printed, you can 
select the WordPerfect View document feature. As soon as you boot up the system and select the WP91 
start-up command from the menu, an initial WordPerfect start-up screen appears briefly. After that initial 
start-up screen, you will be presented with the document screen. On it, a default status line indicates the 
document window you are in (in WordPerfect, you can work on two documents at the same time) as well as 
the current page, line, and honzontal cursor position. The cursor always starts out in the upper-left corner. 
WordPerfect always starts you off in document 1 on page 1, and with top, bottom, left, and right margins of 
1 inch. You issue commands to WordPerfect by pressing the function keys at the top (or left) of your 
keyboard, either alone or in combination with the <Ctrl>, <Shift>, and <Alt> keys. To see the formatting 
codes that are being used in your document, you press Reveal Codes (<Alt-F3>). You close this Reveal 
Codes window by pressing <Alt-F3> again. (Note: <Alt-F3> is also an example of a combination keystroke. 
It is done by first pressing the <Alt> key and, while the <Alt> key is held down, pressing the <F3> key. All 
combination keystrokes are done in this manner.) 


tarting WordPerfect 


1. Turn on your computer and log onto the network (follow the instructions provided 
at your computer). You will see, for the various applications available on the network, the 
1DIR menu with the batch file listings (files with BAT extensions, that execute appiication 
programs). 
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2. Using the Arrow-Down key, move the select bar to the WP51.BAT file and press 
the <ENTER> (also called the <Return>) key. (NOTE: In 1-250, you must have a 
formatted disk to Insert in Drive A: before you can access WordPerfect. In 1-224, 
you may use WordPerfect without your own disk; your work will be stored on 
C:\DATA (Drive C: in the DATA subdirectory). However, you will want to copy your 
work onto your floppy disk to keep with you since the filles on the C: drive may be 
deleted at any time.) 


3. The WordPerfect document screen then appears. It is a blank screen except for 
the status information noted earlier); it is as if you were looking at a blank sheet of paper 
in a typewriter. 


WordPerfect’s online help is available any time you are working with the program. 


1. To get help about the use of a particular function key or keystroke combination, 
press <F3> (Help) and then press the key or keystroke combination to begin viewing the 
information. 


2. To get help about a particular feature/command by name, press <F3> followed by 
the initial letter of the feature/command name (such as <S> to get help on Search). 
When a letter has more entries than will fit on one screen, type the letter again to display 
another screen of entries. After locating the name of the feature on the Help screen, 
press the function keys indicated under the keystrokes column to obtain information about 
the feature’s use. 


3. WordPerfect’s Help system is context sensitive, so when you are using a particular 
function, you can get more information about it by pressing <F3>. 

4. To display a diagram of the function key assignments for WordPerfect, press <F3> 
twice. A template of WordPerfect’s function keys (Enhanced Layout) will appear on your 
screen. Press <1> and the IBM PC/XT (IBM Layout) will be displayed. 


5. Press the <ENTER> key or <Space Bar> to exit the Help system. 


etrieving a Document 


1. To start a new document, just begin typing in the document screen you are 
presented with at start-up. 





2. To retrieve a document from a floppy disk: 


65 


a. Press Retrieve <Shift-F10>, 


b. Type in the drive, path, and document name (e.g., 
A:\work\document.doc), and 


c. Press <ENTER>. 
3. If you do not remember the name of your document: 
a. Press <F5> (List Files), 


b. Type the appropriate drive and path (e.g., A:\work\*.*) to see the files in your 
work subdirectory on floppy Drive A:, 


c. Highlight your document by using the arrow keys to move the cursor bar, and 
d. Select the Retrieve option (type <1> or <R>). 

4. List Files <F5> gives you an alphabetical listing of all files in the current or 
specified directory and allows you to perform common maintenance tasks: copy, delete, 
move, rename, print, and find. 

5. If you retrieve a document while you are working on another document, you will see 


the prompt Aetrieve into current document?No(Yes). \If you type <Y>, the document will 
be retrieved into the current cursor position in the document that is already on the screen. 





reating a WordPerfect Document 


You can begin work immediately when you have the WordPerfect screen 
displayed on your monitor. You do not have to press <ENTER> at the end of each line 
since WordPerfect automatically word wraps for you. You do need to press <ENTER> 
at the end of each paragraph. 


Moving the Cursor 

The cursor is normally a small, flashing underscore that indicates the position of each 
character you type to the screen. If you want to edit some text, you have to move the 
cursor to the desired location in the document. 


1. The four arrow keys on the right of the keyboard are the cursor movement keys. 
These arrow keys are collocated with the numbered keys on the numeric keypad. Press 
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the <Arrow-Up> key to move one line at a time up the page; the <Arrow-Down> key to 
move down one line, the <Arrow-Left> key to move left one character at a time, and the 
<Arrow-Right> key to move right one character. If you press a key down and hold it, the 
cursor will move continuously in the direction of the arrow. 

2. To move the cursor one WORD at a time, press the <Ctrl> key and hold it down 
while you press the <Arrow-Left> key or the <Arrow-Right> key. Holding the <Ctrl> key 
down while pressing the <Arrow-Up> or <Arrow-Down> key will move the cursor to the 
beginning of the previous or next PARAGRAPH, respectively. 


3. The <Page-Up> and <Page-Down> keys will move you to the beginning of the 
previous or the next PAGE, respectively. 


4. The Minus key <-> on the right side of your keyboard adjacent to the numeric 
keypad moves the cursor to the top of the SCREEN and the Plus key <+> next to the 
numeric keypad moves the cursor to the bottom of the SCREEN. 

5. Other cursor movement techniques are as follows: 

To Move <Key Sequence> 

To the beginning of a line Home, Home, Arrow-Left 
To the left edge of screen Home, Arrow-Left 

To the end of a line End; or Home, Arrow-Right 
To cursor’s prior position Ctrl-Home, Ctrl-Home 

To the top of the page | Ctrl-Home, Arrow-Up 

To the bottom of the page Ctrl-Home, Arrow-Down 
To a specified page (Go To) Ctrl-Home, {page number}, ENTER 
To the top of the document Home, Home, Arrow-Up 

To the end of the document Home, Home, Arrow-Down 
Inserting Text into Your Document 


Editing a document often requires adding new text. WordPerfect starts off in the 
default /nsert mode. (If you see the word Typeover in the lower-left corner of your 
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screen, press the Insert <Ins> key located on the right side of your keyboard to return 
to the Insert mode.) 


1. Position the cursor at the spot where you want to insert text. 


2. Press the <Arrow-Down> key and WordPerfect will adjust the text to the correct 
margins. 


Deleting Text 


WordPerfect has many ways of deleting text, many of which are defined here: 


To Delete <Key Sequence> 
Character by character Backspace (deletes to left of cursor); 


Delete <Del> (deletes character or space the cursor is on). 


Word by word Ctrl-Backspace 


Several words Escape <Esc> n (n= number of words to the left of the 
cursor) Ctril-Backspace 


From the left of the cursor Home, Backspace 
to the beginning of a word 


From the cursor right to the Home, Del 
end of a word (including the 
ending space) 


To the end of a line Ctrl-End 

To the end of a page Ctril-PgDn 

A sentence Ctrl-F4, S, D 
A paragraph Ctri-F4, P, D 
A page Ctri-F4, A, D 


Undeleting Text 
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WordPerfect 5.1 can restore any of the last three deletions at the cursor’s position. 
lf WordPerfect is not carrying out a command, the Cancel key <F1> functions as the 
Undelete key. The following prompt appears along with the most recently deleted text: 

Undelete: 1 Restore; 2 Previous Deletion: O 
Choosing Restore <1> or <HR> restores the displayed text to your document; choosing 
Previous Deletion <2> or <P> displays the text that was deleted prior to that deletion. 
The last three deletions can be displayed and restored. After the third most recently 
deleted text is displayed, selecting Previous Deletion displays the first deletion again. 
Selecting Restore restores the displayed deletion to your document. 


Using the Typeover Feature 





With the Typeover feature, you can enter replace existing text without pushing the rest 
of the sentence to the right. Press the Insert <Ins> key until the Typeover prompt 
appears in the lower-left corner of your screen. The /nsert mode is now off. 


unction Keys 


The function keys are listed here alphabetically and sequentially by F—key. 





Alphabetical Listing 


Function <Key Sequence> Brief Description 


Block Alt-F4 Defines a block of text on which you can 
then perform any number of operations. 


Bold F6 Prints selected text in boldface or doublestrike. 
Cancel/ F1 Terminates almost any command being carried out/ 
Undelete Restores up to three previous deletions. 

Center Shift-F6 Centers text on a line between left & right margins. 
Columns/ Alt-F7 Format your text using columns/create tables. 
Tables 

Date/ Shift-F5 inserts the current date as text or code/create an 
Outline outline of your document. 

End Field F9 End of field code in a record (used in merging). 
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Exit 
Flush Right 


Font 


Footnote 


Format 


GoTo 


Graphics 


Hard Page 


Help 


indent 


Indent 


List 


Macro 


Macro 
Define 


F7 
Alt-F6 


Ctri-F8 


Ctrl-F7 


Shift-F8 


Ctrl-Home 
Alt-F9 
Ctrl-ENTER 
F3 

F4 

Shift-F4 


FS 


Alt-F10 


Ctrl-F10 


Quits WordPerfect or current screen. 
Aligns your text flush with the right margin setting. 


Allows you to change the size or appearance of the 
current fonts used in your document. 


Allows you to add footnotes that appear at the bottom 
of the page or endnotes that appear at a place of your 
choice in the document. 


Controls most aspects of the document format using 4 
submenus: Line, Page, Document, and Other. Used to 
set margins. 


Moves the cursor to a specific character, page, or 
text column, or to the previous cursor position. 


Allows you to combine graphics created by other 
programs with the text of your document or to draw 
rules (lines) in the document. 


Ends a page at the discretion of the user. 


Gives you on-line help about a function key, function, 
or a WordPerfect command. 


Sets a temporary left margin and aligns all text to 
this indent until you press <ENTER>. 


Sets temporary left and right margins and aligns all 
text to these indents until you press <ENTER>. 


Displays an alphabetical listing of all files 
in the current directory; allows common 
maintenance tasks: retrieve, delete, 
move/rename, print, copy, text in, and look 
Executes a defined macro. 


Defines a macro (begins recording keystrokes which 
can be replayed any time). 
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Margin 
Release 


Mark Text 


Merge 
Codes 


Merge/Sort 


Move 


Print 


Replace 


Retrieve 


Reveal 
Codes 


Save 


Screen 


Search 


Search 


Shift-Tab 


Alt-F5 


Shift-F9 


Ctrl-F9 


Ctrl-F4 


Shift-F7 


Alt-F2 


Shift-F10 


Alt-F3 


F10 


Ctrl-F3 


F2 


Shift-F2 


Moves the cursor one tab stop to the left. 


Compares documents, removes redline markings and 
strikeout text, and creates automatic references, 
master documents, indexes, lists, tables of 
authorities, and tables of contents. 


Designates a field from the secondary file to be 
merged in the primary file. 


Performs a merge of data stored in lists ina 
secondary document into the appropriate places in a 
Drimary document. 


Allows you to move, copy, or delete a sentence, 
paragraph, or page. You can then move to another 
place in the document and retrieve the text. 


Allows you to print a document or page. Also allows 
other functions, such as view document. 


Allows you to select any sequence of characters or 
codes and globally change it to something else. 


Retrieves a document on disk or the last text that was 
cut or copied. 


Splits the screen and allows you to see the hidden 
codes, which instruct the printer on how to format text 
and graphics in the document. 

Saves a document on disk under the name you assign. 
Allows you to draw straight lines and boxes in the 
document, turn off/on automatic screen writing, and 


split the document screen into two windows. 


Locates the next occurrence in the document of 
specified text or formatting codes. 


Performs a backward (reverse) search. 


qin 


Setup 


Shell 


Spell 


Style 


Switch 


Tab Align 


Text In/Out 


Thesaurus 


Underline 


Shift-F 1 


Ctrl-F1 


Ctrl-F2 


Alt-F8 


Shift-F3 


Ctrl-F6 


Ctrl-F5 


Alt-F1 


F8 


Sequential F-Key Listin 





ALT TTS 





<Key> 


Cancel 


>Search 


Allows you to change many of WordPerfect’s default 
settings. 


Allows you to exit temporarily to DOS. 


Allows you to check the spelling of a word, a block of 
text, or an entire document. 


Allows you to store sets of formatting commands that 
can be applied to various parts of your document. 


Converts defined block to all UPPERCASE or all 
lowercase letters. Switches between the Doc 1 and 
Doc 2 editing screens. 


Aligns text on or around the next tab stop using the 
decimal/align character. 


Allows you to retrieve a DOS text (ASCII) file into 
WordPerfect; to save a document as a DOS text or 
other formats (such as previous versions of 
WordPerfect); to create document comments; and to 
assign passwords to documents. 


Allows you to look for synonyms for any word in the 
text of your document. 


Begins underlined text or underscores selected 
portions of text. 


<Alt> <Shift> <Ctri> 
Thesaurus Setup GoTo DOS 
Replace <Search Spell 
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Help Reveal Codes Switch Screen 











>Indent Block >Indent< Move 

List Mark Text Date/Outline Text In/Out 
Bold Flush Right Center Tab Align 
Exit Columns/Table Print Footnote 
Underline Style Format Font 

End Field Graphics Merge Codes Merge/Sort 
Save Macro Retrieve Macro Define 





lock Operations 


The Block command <Alt-F4> is used to highlight (mark) a section of text for use 
with other WordPerfect commands. To mark a block of text: 





1. Position the cursor at the beginning of the block and press Block (<Alt-F4:). The 
message Block on begins blinking at the bottom—left of your screen. 


TS 


2. Position the cursor at the end of the block (as you move the cursor, the included 
text will be highlighted), then press Block (<Alt-F4>) again. 


3. Select the operation you want applied to the block. You can choose from the menu 
items at the bottom of the screen or use a function key or combination of function keys, 
as summarized below: 


<Key Sequence> 
F1 (Cancel) 


Alt-F2 (Replace) 
Ctrl-F2 (Spell) 
Shift-F3 (Switch) 


Ctrl-F4 (Move) 


Alt-F5(Mark Text) 
F6 (Bold) 


Alt-F6 (Flush 
Right) 


Shift-F6 (Center) 
Shift-F7 (Print) 
F8 (Underline) 
Shift-F8 (Format) 


Ctrl-F9 (Merge/ 
Sort) 


F10 (Save) 


Action with Block On 


Cancel block 

Replaces in block 

Checks block 

Changes block to all uppercase or lowercase 


Cuts, copies, or moves block; Cuts/copies column or 
rectangle 


Marks for ToC, list, index, paragraph numbering 
Bolds block 


Moves block flush with right margin 


Centers block 
Prints block 
Underlines block 
Protects block 


Sorts block 


Saves block in a new file 





rinting and Viewing a Document 
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From the screen, you can print the entire document, a single page, or a marked block of 
text. It’s a good idea to view your document before you print, though, to make sure it 
looks like you want it to look; you will save costly printer paper and time by first 
previewing your document. 


Printing 


The system boot disk provided automatically captures a printer port for your 
workstation when you log in, thereby ensuring that print jobs go to the file server queue 
and subsequently print on network printers. You do not have to manually select a port. 


1. Press the Print key (<Shift-F7>). WordPerfect presents you with a Print menu. 


2. Press the <1> or <F> to print the entire document (the cursor may be placed 
anywhere in the document to print the whole document), or the <2> or <P> to print one 
page (it will print the page the cursor is on at the time). You are returned to your 
document screen, and the print job goes to the file server print queue where it waits its 
turn to be printed. A separator page with the network operating system’s name, your 
login name, and the print job number will be printed first so you can identify your print job. 


3. To print a block of text from the screen, move the cursor to the first character of the 
block you want to print; press <Alt-F4> (Block). The message Block flashes in the lower- 
left corner of the screen. 


4. Move the cursor to the character space immediately after the last character of the 
block of text you want to print. Press <Shift-F7> (Print). 


5. Press <Y> for yes to the prompt Print block? No (Yes). 
Viewing 


You can view the document pages as they will appear when printed on paper, 
including graphics, footnotes, page numbers, line numbers, headers, footers, and 
justification. However, on the Token Ring network in I—-224, three computers (TN12, TN15, 
and TN23) will not allow you view without a few extra steps; that’s because WordPerfect 
is preset for EGA monitors whereas these three stations have CGA monitors. For 
instructions, see the footnote’. 


* To be able to view your document from TN12, TN15, or 
TN23 on the Token Ring network in I-224, you need to reset the 
default monitor selection by following these steps: 
1) Press <Shift-F1l> (Setup) ; 
2) Select <2> (Display); (continued next page) 
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1. Put the cursor on the page you want to view. 
2. Press <Shift-F7> (Print) and select <6> or <V> (for View document). 


3. Press <1> (100%) to view the document at its actual size; 
press <2> (200%) to view at twice its actual size; 
press <3> (Full Page) to view the whole page at once; 
press <4> (Facing Pages) to view the current page and its facing page 
(even—numbered pages are shown on the left, odd—numbered pages on the right). 


4. Press <PgUp> or <PgDn> or <Ctrl-Home> (GoTo) to view other pages in the 
document. 


5. Press <F7> (Exit) to return to the document screen. 


aving a Document 


Once you create or modify your document, you will want to save it on your floppy 
diskette. You can save the document either while you are still working on it or when you 
are finished with and are ready to exit WordPerfect. It is, however, a very good idea to 
SAVE often!! It only takes a few seconds and can save HOURS of retyping. 





Saving without Exitin 





You should save your document every 10-15 minutes in case there’s a power surge 
or failure affecting your workstation or the file server. If you leave your workstation for 
any reason while working on a document, make it a habit to save your work first. 


1. Press Save (<F10>). You will see this prompt in the lower—left corner of your 
screen: Document to be Saved:. 


a. If you retrieved the document from your floppy diskette or saved 
the file previously, WordPerfect will provide the drive, path, and 
document name (e.g., A:\WORK\DOCUMENT.DOC) as a 

default. 


3) Select <2> (Graphics Screen Type) ; 

4) Select <2> (Auto-select) ; 

5) Press <ENTER>; 

6) Press <ENTER>, then follow the instructions for viewing in 
the body of the guide. 
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(1) To save the file under the same name, press <ENTER> and 

respond <Y> to the prompt Replace ANWORK\DOCUMENT.DOC ? 

No(Yes) to indicate that you do want to replace the original 

version of the file with the edited version. The default setting is No, which allows 
you to leave the existing file intact and save the new version under another 
name. 


(2) If you want to rename the file in order to keep two versions 

of a document, press <ENTER:s> to accept the No setting. WordPerfect will allow 
you to enter a new file name (including drive and path designations). Type the 
new name or edit the existing name, then press <ENTER>. 


b. If you newly created the document and have not saved the file 
previously, WordPerfect will prompt you for a file name. Type ina 
drive and path designation, and a file name of up to eight 

characters with an optional three—character extension (characters 
after the dot); for example, A:\WORK\DOCUMENT.DOC. Then press 
<ENTER>. The file will be saved on your floppy disk. 


2. Once the document has been saved, you will be returned to the document screen. 


Saving and Exiting WordPerfect / Clearing the Screen 


When you are finished with your word processing session, you will want to save your 
latest document and exit WordPerfect. 


1. Press <F7>, the Exit key. 


2. You will see the prompt, Save document? Yes(No). Press <ENTER> or <Y> to 
accept the default setting of Yes. If you want to abandon the document and any changes 
you have made to it, press <N>. You can then exit without saving the document. 


3. After you have pressed <ENTER>, WordPerfect prompts you for the name of the 
document. 


a. If you have not saved the document before, type in the directory 
path and document name and press <ENTER>. (Remember to save your 
work to your formatted floppy disk before leaving.) 


b. If you have already saved the document at least once, the prompt 


will contain the directory path and document name. 
(1) If you want to save it under the same name, simply press 
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<ENTER>. WordPerfect will respond with the prompt, Replace 
A:\WORK\IDOCUMENT.DOC ?No(Yes). |f you change your mind and 

decide to rename the document, press <ENTER>. Otherwise, type <Y> for Yes. 
(2) If you want to save the document under a new name, type it in or edit the 
existing name and press <ENTER>. 


4. After the document is saved, you will see this prompt, Exit WP ?No(Yes). 


a. The default response is No, so you can press <ENTER> or <N> to 
CLEAR THE SCREEN and begin creating a new document or retrieve another 
document for editing. 


b. If you decide you do not want to have your document cleared from the screen, 
press Cancel (<F1>) to retain it and return to editing its text. 


c. If you answer Yes to exiting WordPerfect, you will be returned to the 1DIR menu 
to select another application or log off the system. 
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ntroduction to Local Area Networks 


A local area network (LAN) is a group of microcomputers or other workstation 
devices located in the same general area and connected by a common cable. A LAN is 
designed to interconnect microcomputers, terminals, minicomputers, and other hardware, 
for the purpose of communicating among themselves and alternately with a host 
mainframe computer or public network. 





The most common reason for developing a LAN is resource sharing. Networks allow 
the sharing of peripheral devices such as hard drives, printers, and scanners. Application 
programs such as spreadsheets, word processing, and communication packages can be 
shared so that multiple copies are not necessary. Databases can also be shared in such 
a way that multiple microcomputers can have access to a single database. This capacity 
for sharing hardware and software resources allows greater flexibility and cost savings 
in the use of expensive computer peripherals and software. 


The basic components of a LAN are the server computer, the user computer(s), and 
the interconnecting cabling system. The server is usually a microcomputer that is 
specifically designated to act as the network server. The server performs only those 
functions required of a network server; it can only be accessed by users through their 
user computers. Server functions include repository of software programs, network 
management, printer and other peripheral device management, and database repository. 


The user computer is normally a microcomputer or terminal, and is connected to the 
server by a cabling system. A simplified schematic of a typical connection is shown in 
Figure 1. One server can support more than one user computer, usually six to ten. The 
cabling system connecting the server and the users can be present in a number of forms 


PHONE LINE 





Figure 1: LAN Schematic 
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and configurations. Cabling can be twisted pair wire, coaxial cable, and fiber optic cable. 
Configurations include bus, ring, and star. 


Logging on to a LAN as a user gives access to all the software on the server. When 
a software package is chosen, a copy of the software is downloaded to the user computer 
for execution. The user computer executes the software like a standalone computer, not 
accessing the server again unless a peripheral device, such as a printer, is needed. 
Further information on these and other local area network topics can be found in the 
references listed below. 
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dBase IV is a database management system which lets you create many different 
types of databases, make data additions and deletions, search for records with a variety 
of search criteria, sort data into multiple formats, print mailing labels, generate reports, 
and. if you work with numerical data, perform various mathematical computations. This 
guide is designed to familiarize the beginning user of dBase IV with a few of the 
program's basic operations. More comprehensive treatments are available which cover 
more of the many features dBase IV offers. 


Like other applications, the dBase IV program is stored on the file server hard disk in 
its own subdirectory. Database files which you create and work with should be stored on 
your floppy disk or a class subdirectory, which your instructor will explain. 


dBase IV stores information in database files which consist of records (or rows). Each 
record is divided into separate fields (or columns). Figure 2 depicts a dBase IV database 
file containing names and addresses. Forms, such as the most basic Edit screen, are 
used to gather information on the computer screen and that information is stored in the 
database file. Reports are derived from 
the information in the database and can 
be printed, in the format you specify, on eee 


your computer screen or printer. dBase IV cot 
can also pull together information from 


separate database files into a single ‘Name __FName Address Ghy 2p 
printed report. In managing a database, = Jones Edward 123 First St. — Montorey 93940 
you execute a few basic tasks: Smith May 321 A Ave. Salines 99093] Boa. 
Clyk Ray 8475 ThidSt Camel gcoes<; (rows) 
— ADD new information Patrick Pamela 24CasaVerde Monterey 93940 
— CHANGE information Black Gerald 680GreenRd. Capitola 99011 
_ SORT he ae Figure 2. A dBase IV Database File 
some useful order (like alphabetical 
order) 


— SEARCH for particular types of information (like a specific address 
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or names of all people with San Diego addresses) 
— CALCULATE totals, subtotals, counts, and averages 


dBase IV offers an optional command-driven technique for managing databases, 
where you type commands at a dot prompt screen rather than select options from pull— 
down menus. This guide does not deal with the command-—driven technique. However, 
if you inadvertently get to the dot prompt, you can get back to the Control Center by 
typing ASSIST and pressing Enter, or just pressing the F2 key. 


tarting dBase IV 


1. Turn on your computer and log onto the network (follow the instructions 
provided at your computer). You will see the 1DIR menu with the batch file (files with 
.BAT extensions, that execute application programs) listings for the various applications 
available on the network. 


2. Using the Arrow-Down key, move the select bar to the DBASE4.BAT file and press 
the Enter (also called the Return) key. 


3. The dBase IV logo and copyright notice appear on the screen, along with the 
message "Press Enter to assent to the License Agreement and begin dBase IV." 


4. Press Enter to start the program or wait a few moments and dBase IV will display 
the Control Center. 


he Control Center 


After the dBase IV logo and copyright notice disappear, the Control Center 
appears on your screen. The operations performed by dBase IV are initiated from the 
Control Center. The Control Center provides a user interface based on pull-down menus, 
rather than commands, for interacting with dBase IV. It is the primary user—assistance 
feature for non—programmers in dBase IV. The five major parts of the Control Center are: 
the menu bar, the catalog line, the file panels, the current file description line, and the 
navigation line. The pointer is a highlighted bar that is moved by the Arrow keys to the 
menu options and files; to select an option from the Control Center, position the pointer 
and press Enter. 


The Control Center displays the names of files in the current catalog in the panels, 
which are labeled Data, Queries, Forms, Reports, Labels, and Applications. The names 
of various files from other users may appear in these panels, but they will not affect your 
work. 
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The Menu Bar 


At the upper-left corner of the Control Center is the horizontal menu bar, which offers 
the options Catalog, Tools, and Exit. Each option has a pull-down menu associated with 
it. 


1. Pull-down menus can be accessed by pressing the Menu key (F10) or by holding 
down the Alt key and typing the first letter of the option you want. 
a. Shaded options here are not available at the moment, usually because they make 
no sense in the current situation. 


b. Bulleted options (those with arrows/right-pointing triangles) have submenus 
associated with them. 


2. To leave the pull-down menus at any time, press the Esc key until the menus 
disappear. 


The following keys are used to navigate the pull-down menus. You may want to try 
some of these keys to see how they work. 


KEY EFFECT 

Enter Selects the currently highlighted option 

Arrow-Left, Moves to menu-bar option on left or right 
-Right 

Arrow-Up, Moves up or down to next available pull-down menu option 
-Down 


PgUp, Home Moves to first available pull-down menu option 
PgDn, End Moves to last available pull-down menu option 


First letter of 
any option Selects that option 


Esc Backs up to prior menu or Control Center 


The Catalog Line 


The catalog line is centered beneath the title of the Control Center screen, and 
displays the name of the current catalog. If no catalog has been created, the catzlog line 
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will read UNTITLED.CAT. A catalog is a grouping of related files in a database, such as 
storing accounts receivable information in one catalog and inventory information in 
another. 


The File Panels 


The file panels of the Control Center are the six vertical rectangles in the center of the 
screen labelled Data, Queries, Forms, Reports, Labels, and Applications. They contain 
the names of the various types of database files in the current catalog. For instance, the 
Data panel holds the names of database files that contain data; the Forms, Reports, and 
Labels panels hold the names of formats used to display forms and to print reports and 
mailing labels; and the Queries and Applications panels hold the names of query files and 
dBase !V application programs (dBase IV applications will not be covered by this manual). 
Each panel also includes the option <create>, which allows you to create a new database 
file, form, report, or query; it is placed into the current catalog. 


The Current File Description Line 
The File: and Description: section, just beneath the file panels, provide the name of 
the currently selected file and a brief description of the file’s contents. If <create> is 


highlighted instead of a file name, this area displays "New file" and "Press ENTER on 
<create> to create a new file." 


The Navigation Line 
At the bottom of the screen is the navigation line. It displays the commands that are 


available for the option currently selected. As an example the navigation line displayed 
at the Control Center shows: 


Help: F1 Pressing F1 always displays a Help screen 
Use: Use the highlighted item 
— Enter (Return) 


Data: F2 Display data in Browse mode (Pressing F2 a second 
time displays data in Edit mode) 


Design: Shift-F2 Displays the Database Design screen 
Quick Report: Shift-F9 Displays the Print menu. 
Menus: F10 Activates the menu bar 
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etting Help 


You can use the Help key (F1) at any time to get help with dBase IV. The help 
screens are context sensitive, which means they provide help that is relevant to the 
operation you are currently performing (whichever operation is currently highlighted). 
After pressing F1, a help screen (or window) will appear on the screen. The navigation 
line at the bottom of the screen will tell you the keys to use to navigate the help screens, 
usually F4 for next screen and F3 for previous screen. The Arrow-Left and Arrow-Right 
keys will move you among any help options offered in the help window. 


The help system’s Table of Contents can be accessed by highlighting the CONTENTS 
option and pressing Enter. You'll see a list of topics concerning database files. 


HELP OPTION BRIEF DESCRIPTION 

CONTENTS Displays a table of contents for the current topic. When a table of 
contents is displayed, you can use the F3 (More General) or F4 
(More Specific) key to change to more general or more specific 
tables of contents. 


RELATED TOPICS Displays a list of topics related to the current topic. 


BACKUP Scrolls back to the previous screen. This option only appears if 
there is a previous screen. 


PRINT Prints a copy of the current help window. 


When you are finished with the help system, return to the Control Center by pressing 
the Esc key. 


reating and Saving a Database Structure 


Each piece of raw data—a phone number, name, street address, inventory code, 
and so on—is placed into its own field. Several fields of related data are grouped 
together to create a record. Records are compiled into a database file, and related 
database files are organized into a catalog. 


Creating a Catalog 


A catalog name is a DOS filename of up to eight letters or numbers. An extension is 
not included because dBase IV assigns the extension .CAT to all catalogs. 
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1. To open the Catalog menu, press F10, the Menu key. The pointer moves to 
"Catalog" on the menu line, and the Catalog menu drops down. 


2. The pointer is on the "Use a different catalog" option. Press the Enter key. The 
Catalog box appears in the upper-right corner of the screen. You may see a list of 
previously created catalogs. You may select one of these and press Enter to display a 
list of that catalog’s files, or 


3. Place the pointer on <create> and press the Enter key to create a new catalog. 


4. Type the name of your new catalog and press Enter. You are returned to the 
Control Center, where the new catalog name will appear in the catalog line. 


Defining Data Fields 


A data field contains one specific item of data. The Database Design screen is where 
you define each field in your database structure. 


i. The pointer should be positioned on <create> in the Data panel. Press the Enter 
key. The Database Design screen appears. (Notice the message and navigation lines 
at the bottom of the screen. dBase is prompting you to enter the first field name. Also, 
a new line of highlighted information, called a status line, appears at the bottom of the 
screen.) 


2. To define the fields you want to use in your records, you must fill in the options 
indicated by the six field panel headings: Num, Field Name, Field Type, Width, Dec, and 
Index. 


a. Num: The Num column tells you the field number you are working with. It is 
defined by dBase and cannot be specified. 


b. Field Name: You can enter any name that will identify the type of information to 
be entered in that field, up to ten characters (either upper— or lower-case). It 
can contain only letters, numbers, and underscores and the first character must 
be a letter. Each field name in a database file must be unique. 


c. Field Type: Here, you must specify what kind of information the field is going to 
hold. There are six options, which you can select by pressing the space bar until 
your choice appears in the place where "Character" originally appears. 
"Character" is the default setting since most database fields are of character 
type. You can also type the first letter of a choice to select it. The six types are: 
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1) Character type: all letters, punctuation marks, special symbols, and any 
numerals, like Zip codes and phone numbers. (Mathematical calculations cannot 
be performed on numbers in this field type.) 

2) Numeric type: numbers that will later require mathematical calculation or that 
have a fixed decimal point, such as dollar amounts. 

3) Float type: numbers that have a floating decimal point, values that sometimes 
require a decimal point and sometimes do not, and negative numbers. 

4) Date type: dates such as 9/26/91. 

5) Logical type: true/false or yes/no entries. 

6) Memo type: This field type can include large amounts of texts, such as 
abstracts, comments, or lengthy descriptions. 

Select the field type and press Enter. 


d. Width: Here you must specify the maximum number of letters, numbers, or other 
characters that you plan to put into the field. The Logical, Memo, and Date fields 
are automatically assigned a width by dBase IV, so you have to specify a width 
only for Numeric, Float, and Character fields. 

Specify the number of characters, then press Enter. 


e. Dec: If you entered N (for Numeric) as the field type, the cursor will stop in this 
column. You must enter here the number of decimal places you want in the 
field. For example, for monetary figures you would type 2 to indicate that you 
want two decimal places. 

Type in the number of decimal places and press Enter. 


f. Index: This column is used to control how dBase orders your records. A Y(es) 
or N(o) indicates whether or not the field should be indexed. If this option is 
changed to Y, dBase will assign the name of the field as the name of the index 
and actually create the index when you save the database structure. For more 
on indexing, see Indexing, page 13. 

Type Y or N and press Enter. 


3. The cursor is now positioned to define the second field. Following the procedure 


described above, enter the remaining field information for your record and save this 
database file structure as described in the "Saving the Database Structure” section below. 


Making Changes and Corrections 
At this point, if you notice an error in your file structure or wish to make a change, you 


can use the keys described here, to change your database file structure. The keys wont 
always work if you attempt to leave a field that has incomplete or invalid data. You may 
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have to experiment with several keys or type Ctrl-U to completely delete an incomplete 
or invalid field to get the cursor moving in the direction you want. 


KEY 
Enter 


Arrow-Left, 
-Right 


Arrow-Up, 
-Down 


Home 
End 
Ctrl-End 


Tab 


Shift-Tab 


Backspace 
F1 (Help) 
F2 (Data) 
Ctrl-N 
Ctrl-U 
Ctrl-W 


Shift-F2 
(Design) 


Esc 


EFFECT 
Completes an entry and moves to the next column or row 


Moves cursor one character to the left or right 


Moves highlight up or down one row 


Moves cursor to the first column in the row 
Moves cursor to the last column in the row 
Saves changes and exits the Database Design screen 


Moves cursor one column to the right (only if valid information is already 
in the present column) 


Moves cursor one column to the left (only if valid information is already 
in the present column) 


Moves cursor one space back, erasing along the way 
Displays Help screen 

Switch to browse or edit screen 

Inserts a blank field between two existing fields 
Deletes the current field 

saves changes and exits the Database Design screen 


Transfer to Query Design screen 


Exits without saving changes and returns to previous screen 
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Saving the Database Structure 


1. From the Database Design screen, pull down the Layout menu by pressing the F10 
Key. | 


2. Move the pointer to Save this database file structure. Press the Enter key. The 
Save as: box appears. 


3. Type in the name of your database file (dBase IV will add the file extension .DBF 
to each database file) and press Enter. The database file structure is now saved, ready 
to be filled with the actual data for each record. 


4. To exit the Database Design screen and return to the Control Center, press the F10 
key. The Layout menu pops down again but displays different options this time. 


5. Press the Arrow-Right key to move the pointer to Exit. Notice how each menu box 
pops down as the pointer moves from one menu item to another. 


6. At the Exit menu, the pointer should be on the Save changes and exit option. Press 
the Enter key. You are returned to the Control Center. 


WI orking with the Database 


Placing information in your database files begins with creating records and 
entering data into the fields from the Edit screen. The records can also be edited on the 
Edit screen. The Edit screen looks like a blank form for a single record and is useful 
when you want to concentrate on one record at a time (custom forms can be created for 
entering and editing data, but are not covered in this guide). You can move from field to 
field using the following keys, which are useful in the Browse screen also: 

KEY EFFECT 


Enter Completes entry and moves to next field 
Arrow-Left, Moves the cursor left or right one character 
-Right 
Arrow-Up, Moves the cursor up or down 
-Down 
PgUp, PgDn Moves up or down one record on Edit screen or one screenful on 


Browse screen 
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Home 


Ctrl-Home 


End 


Ctrl-End 
Tab 
Shift-Tab 
ins 
Backspace 
Del 

F1 (Help) 
F2 (Data) 
F3 (Prev) 
F4 (Next) 
F10 (Menu) 
Ctri-Y 


Shift-F8 
(Ditto) 


Esc 


Moves to first filed on Browse screen or first character tn 
current field on Edit screen 


Moves from a memo-field marker into an editing window to add or 
change a memo 


Moves to last field on Browse screen or end of current field 
on Edit screen 


Saves changes and exits to previously used screen 

Moves to next field, or indents paragraph in word—wrap editor 
Moves to previous field, or outdents paragraph in word—wrap editor 
Switches between Insert and Overwrite modes 

Moves left one character, erasing along the way 

Deletes one character over cursor 

Displays help 

Toggles between Browse and Edit screens 

Scrolls back to previous field 

Scrolls to next field 

Accesses pull-down menus 

Deletes all characters to right of cursor 


Carries data from same field in previous record to current 
record 


Leaves current screen without saving changes to last—edited record 


Entering Data into Records 


1. From the Control Center, place the pointer on the database file in the Data panel 
in which you want to place information. Press the Enter key. 
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2. Move the pointer to Display data and press Enter. The fields you created for your 
database structure will appear on the screen. This is the Edit screen as indicated by the 
word Edit at the left end of the status line. 

3. Fill in each field with the appropriate data, pressing the Enter key after each entry. 


When you have filled in all the fields, you will have completed a record and dBase moves 
to the next blank record. 


Editing a Record in the Edit Screen 


From the blank record you are in, press the PgUp key to move to a previous record. 
To move to the field you want to edit, use the Arrow-Up and Arrow-Down keys. You 
can type over existing text (to insert, press the Insert (Ins) key). 


Exiting the Edit Screen 


1. Press the PgDn key until you reach the last record and see the following prompt 
at the bottom of the Edit screen: 


=== > Add new records?(Y/N) 
2. Press Y and a blank set of fields appears. 
3. Press the Enter key and you are returned to the Control Center. 


Editing and Adding Records in the Browse Screen 


1. From the Control! Center, press the F2 key. This is the Browse screen (see left end 
of status line; if it says Edit, press F2 once more). To edit an existing record, simply 
move the cursor to the field that needs changing and type in the correct information. 


2. To add a record, press the Arrow-Down key until the following message appears 
at the bottom of the Browse screen: 


=== > Add new records?(Y/N) 
3. Press Y. The pointer moves to the first field of the next blank record. 
4. Type in the data in the fields, pressing Enter after each entry. 


The keys listed on pages 12 and 13 can be used to navigate the Browse screen. 
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Undoing an Edit 


Occasionally, you may change or erase a field’s contents accidentally. Before you 
move to a new record, you can undo an edit. 


1. Highlight the Records option on the menu bar. 


2. Select Undo Change to Record and the previous contents of the record will be 
restored. 


Memo Fields 


A memo field marker appears as a highlight with the word memo on the Edit and 
Browse screens. When the memo field contains information, the marker is shown in 
uppercase letters. 


1. To open the memo marker, move the cursor to it and press Ctrl-Home or F9 
(Zoom). 


2. After editing the memo field, save your work and return to the form or Edit screen 


by selecting Save Changes and Exit from the Exit pull-down menu or by pressing Ctrl- 
End. 


Viewing a List of Records 


On the Edit screen you are limited to viewing one record at a time. With the Browse 
mode, however, you can view a screen full of records. 


1. From the Control Center, move the pointer to a database file name in the Data 
panel. 


2. Press the F2 key. The Browse screen should appear. If the Edit screen appears, 
press F2 again. The records are listed down the screen and field columns are displayed 
across the screen. If you see only one record, press the PgUp key to pull other records 
into view. (Note: You may not see all the fields at once. Use the Tab key to view 
hidden columns.) 


Marking Records for Deletion 


Before you delete a record it must be marked for deletion. From the Browse screen, 
you can mark one or more records at a time using either of two different methods. 


Method one: 


Ou 


1. Move the pointer to the first field of the record to be deleted and press F10. The 
Records menu appears. 


2. Move the pointer to the Mark record for deletion option and press the Enter key. 
3. The record is now marked. Notice the Del at the right end of the status line. 
Method two: 


1. From the Browse screen, move the pointer to the record to be deleted, then press 
Ctri-U. 


2. The record is now marked and Del is displayed on the status line. 
Unmarking a Record for Deletion 
There are two methods to unmark a record for deletion. 


Method one: 


1. Place the pointer on the marked record and press the F10 key. The Records menu 
appears. 


2. Move the pointer to the Clear deletion mark option and press the Enter key. 


3. The Del on the status line disappears, indicating the record is no longer marked 
for deletion. 


Method two: 
1. Move the pointer to the record to be unmarked, then press Ctrl-U. 
2. The record is now unmarked and Del disappears from the status line. 


Deleting Marked Records 


When you delete records from the database file, dBase IV shifts the remaining records 
to occupy the space on the disk made vacant by the deleted records. This process is 
referred to as packing the database. 


1. From Control Center screen, press Shift-F2. The Database Design screen appears 
and the Organize menu pops down. 
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2. Move the pointer to Erase marked records. Press Enter. 


3. A box pops out with the question, Are you sure you want to erase all marked 
records? Select Yes and the database is packed. You are returned to the Database 
Design screen. The records have been deleted from the database. 


4. To exit, press the F10 key, move to the Exit menu, and press the Enter key. 


orting a Database 


To sort the information in your database in a useful order, such as alphabetically 
or zip—code order, dBase IV offers two methods. The fastest and most efficient method 
is by indexing. The second way is to make a sorted copy of a database file. This guide 
will only cover the first method—indexing. 


Indexing 


A dBase IV index is a sorted list of items in a database file. When you activate the 
index, dBase automatically displays the records in the sort order specified by the index. 
The actual records in the database are still in their original order; the index just "tells" 
dBase the order in which to display information on the screen or printer. Also, dBase can 
use the index to quickly locate an item of information in the database. 


You can create or modify an index from the Database Design screen at any time, 
whether or not the database contains records. You can create up to 47 indexes for any 
given database. dBase IV stores all the indexes for a given database in a file with the 
same name as the database, but with the extension .MDX. When you add, change, or 
delete records, dBase updates the indexes automatically. 


1. Highlight the database name in the Data panel of the Control Center and then press 
Shift-F2 to invoke the Database Design screen. 


2. Select Create New Index from the Organize pull-down menu and press Enter. A 
submenu appears asking for information about the index. 


3. Press Enter to select Name of Index. Type the index name (also called the tag) 
and press Enter. You can assign any name to the index, following the same basic 
guidelines as for creating field names (see Field Name, page 13). 


4. Now select the Index Expression option and press Enter. Type the <index 


expression> and press Enter. The index expression is a single field name for a simple 
index. You cannot index on logical or memo fields. 
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5. Select the Order of Index option (skip the FOR clause; it will not be covered). You 
can choose Ascending (lowest to highest) or Descending (highest to lowest) by pressing 
the Space bar. 


6. Press Ctrl-End to save your work (the last entry will not be covered either). 


dBase IV will create the index and show its progress on the screen. When it is done, 
the Database Design screen reappears. 


Sorts within Sorts 


If sorting your database on a single field is not sufficient, such as when you want to 
sort records in last-name order and then in first-name order for those with identical last 
names, you need to perform a sort within a sort. To do this, follow steps 1-6 above, 
under indexing. However, use an index expression that lists the fields to sort on in priority 
order with a plus sign (for character types) between each field (e.g., LASTNAME + 
FIRSTNAME). The first field in the expression is the primary sort field, the second is the 
secondary sort field, and so on. 


There are other sorting possibilities but they are beyond the scope of this basic guide. 
Activating an Index 
To make dBase IV use your index: 


1. From the Database Design screen, select the Organize pull-down menu. Highlight 
the Order Records by Index option and press Enter. 


2. Highlight the desired option from the submenu listing index options and press Enter. 
3. Press F2 to view the data in sorted order. If the Edit screen appears instead of the 


Browse screen, press F2 again to switch. If necessary, press PgUp to scroll to the first 
record. 


earching a Database 


dBase IV can search a database for a specific record or grouping of records with 
something in common. 


Searching for Specific Records 
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Both the Browse screen and Edit screen menu bars include the Go To menu, which 
provides options for basic searches. The first four options on the Go To menu let you 
position the Edit or Browse screen highlight on a particular record, based on the record’s 
position in the database file. 


Forward and Backward Searches 


The bottom half of the Go To menu on the Edit and Browse screen menu bars 
displays the Forward Search and Backward Search options. 


1. Bring up the Browse or Edit screen, go to the position in the database you want to 
search from (e.g., select Top Record from the Go To menu to go to the beginning of the 
database), and move the highlight to the field you want to search. 


2. Call up the Go To menu and select Forward (or Backward) Search. 


3. When dBase displays the prompt Enter search string, type the text/numbers you 
want to search for and press Enter. To locate items that match a pattern rather than an 
exact value, you can use the wildcard character ? to match a single character or the 
wildcard character * to match any group of characters. 


Index Searches 

The index search searches the database index rather than the database file and 
usually finds information in large databases more quickly than a forward or backward 
search. The are two stages of an index search: First, using the Database Design screen, 
you activate the index that contains the field you want to search. Second, using the 
Browse or Edit screen, you perform the search. 


1. Highlight the database name in the Data panel of the Control Center and press 
Shift-F2 (Design). 


2. From the Organize pull-down menu, select Order Records by Index. 


3. From the submenu, select the desired index. The field you search must be either 
the sole field indexed on, or the first field in the index expression. 


4. Press F2 (Data) to go to the Browse or Edit screen to conduct your search. 
5. Select the Index Key Search option from the Go To menu. dBase presents the 


prompt Enter search string for <field name>. This is the expression for the current index; 
dBase displays this to tell you what field you currently can search. 
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6. Type the value to search on (including upper— and lower-case letters) and press 
Enter. dBase will locate and display the first record that matches your search string. 


uerying the Database 


The process of selecting specific records from the database is called querying the 
database. The technique you use is called query by example, abbreviated QBE. dBase 
lV presents a skeleton of the database file in use, and you give examples of the kinds of 
information you want dBase to display. Queries are handled via the Query Design 
screen. Keys used to design a database query are described below: 


KEY 
Enter 


Arrow-Left, 
-Right 


Arrow-Up, 
-Down 


PgUp,PgDn 


Ctrl-PgUp, 
-PgDn 


Home 
End 
Ctri-End 
Tab 
Shift-Tab 


Backspace 


Del 


F3 (Prev) 


EFFECT 
Completes an entry in the file or view skeleton 


Moves the cursor one character to the left or right in the file or 
view skeleton 


Moves highlight up or down one row in the file skeleton 


Moves to the next or previous page of file skeletons 


Moves to the top or bottom of the file skeleton column 


Moves cursor to the first field in the file or view skeleton 

Moves cursor to the last field in the file or view skeleton 

Saves changes and exits the Query Design screen 

Moves the cursor one field to the right in the file or view skeleton 
Moves the cursor one field to the left in the file or view skeleton 


Moves cursor one space back, erasing along the way, in the file or view 
skeleton 


Deletes the character the cursor is on, in the file or view skeleton 


Moves back to the previous skeleton 
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F4 (Next) Moves forward to the next skeleton 

F5 (Field) Deletes or reinserts all fields in the view skeleton 

F6 (Select) Highlights a group of adjacent fields in the view skeleton 
F7 (Move) Moves selected text to a new location in the view skeleton 


F9 (Zoom) Expands and shrinks skeleton columns and condition boxes 


Shift-F2 Brings up a Query Design screen for the selected database 

(Design) 

Ctrl-N Inserts a blank row between two existing rows in the file skeleton 
Ctri-U Deletes the entire current row in the file skeleton or condition box 
Ctri-W Saves changes and exits the Query Design screen 

Ctrl-Y Deletes the entire current row in the view skeleton 

Esc Exits without saving changes and returns to the previously used screen 


The Query Design Screen 


Before you can query a database, you must make sure that the database file is open, 
and then you must get to the Query Design screen. 


1. Press Shift-F2 (Design) from the Edit or Browse screen, or use the arrow keys to 
highlight <create> in the Queries panel from the Control Center and press Enter. (After 
you've viewed or worked with the results of a query, you can return to the Query Design 
screen by selecting Transfer to Query Design from the Exit pull-down menu.) In addition 
to the usual menu bar at the top of the screen and the status bar and navigation line at 
the bottom, the Query Design screen includes a file skeleton and a view skeleton. 


The file skeleton, near the top of the screen, displays the names of all fields in the 
database; you will use it to specify search criteria. In the leftmost column is the name of 
the database file that the skeleton represents. Each field name in the database is listed 
in boxes to the right of the database name. You can use the Home, End, Tab, and 
Shift-Tab keys to scroll left and right through these field names and to view those that 
are off the edge of the screen. (Although the Query Design screen initially contains only 
one file skeleton, you can add as many as 7 more, enabling you to construct complex 
queries involving several databases.) 
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2. To specify the records you want a query to display, you enter "filter conditions” in 
the file skeleton. You put the filter condition under the appropriate box (highlight the field 
and enter the filter condition in the field box) and then press F2 (Data) to see the results. 
If the Edit screen appears, press F2 again to switch to the Browse screen. (You can 
remove filter conditions using the file skeleton’s navigation and editing keys.) 


Saving a Query for Future Use 


1. At the Query Design screen, after creating and testing the query using F2, highlight 
the Layout option in the menu bar and select Edit Description of Query. When prompted, 
type a description and press Enter. 


2. Select Save This Query from the Layout menu or Save Changes and Exit from the 
Exit menu. When dBase displays the prompt Save as:, enter a valid DOS file name and 
press Enter. dBase will automatically add the extension .QBE to the file name you 
provide. 


Activating a Saved Query 


1. At the Control Center, highlight the name of the query in the Queries panel and 
press F2. 


2. Three options will be displayed: Use View, Modify Query, and Display Data. 
Selecting Display Data activates the view and takes you to the Edit or Browse screen. 
Selecting Use View puts the view name above the line in the Queries panel. 

3. When finished, select Exit from the Exit pull-down menu to return to the Control 


Center. The view name will be above the line in the Queries panel, indicating that it is 
still active. 


Changing a Query 

1. Highlight its name in the Queries panel and press Shift-F2 (Design). 

2. Modify the query using the same techniques used to create queries. You can see 
the results by pressing F2 (Data). Return to the Query Design screen by pressing Shift- 
F2 (Design). 


3. When finished, select Save Changes and Exit from the Exit pull-down menu to 
return to the Control Center. The query name will still be accessible. 


Deactivating a Query 
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You must deactivate a query to remove its effect on your view of the associated 
database. Simply opening the database file deactivates the query. Highlight the 
database name in the Data panel and press F2 (Data). 
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Creating a Custom Report 





Only basic procedures for creating a customized report are included here. There are 
many more features of dBase IV not covered that you may want to look into, to create 
a report that fits your specific needs. 


1. Ensure that the database is currently in use and, from the Control Center, highlight 
<create> in the Reports panel and press Enter. The Reports Design screen appears. 
The ruler just beneath the menu bar on the Reports Design screen shows margins and 
tab stops. The center of the screen is divided into five bands. Each band corresponds 
to a section of the printed report. Anything that you place within a band is printed only 
in the corresponding section of the report. The five bands are as follows: 

a. Page header: printed once at the top of each page. 

b. Report intro: printed once at the beginning of the report. 

c. Detail: the body of the report. Typically, this section displays records from a 
database file. 

d. Report summary: printed once at the end of the report and can be used to display 
totals or closing information about the report. 

e. Page footer: printed once at the bottom of each page and can be used to display 
page numbers or other useful information. 


2. Select Quick Layouts from the Layout menu. Select a layout from among the three 
options provided: 
a. Column Layout: columnar listings similar to the quick report. 
b. Form Layout: forms using a format similar to the Edit screen for records. 
c. Mailmerge Layout: form letters with information from a database inserted into 
predetermined locations in the letter. 


3. After selecting a general format for your report, select the margins. When printing 
on 8.5 x 11-inch paper, a right margin setting of about 64 will give generally adequate left 
and right margins on the printed page. 

a. Pull down the Words menu from the menu bar and select Modify Ruler. 

b. Press Tab or Arrow-Right to move to the left-margin column, then type "[" to 
mark the left-margin position. Then use Arrow-Right or Tab to position the 
cursor to the right-column margin, and type "]" to mark the right margin. 
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c. Press Ctrl-End to finish modifying the ruler and record changes. 


4. Edit the field templates and text to your satisfaction. 

a. To edit a band, move the cursor to the band border(which contains the band 
name). If the band is closed (no blank space beneath the border), you need to 
open it by pressing Enter and moving the cursor into the band. 

b. Now you can enter and edit text, move fields around, and modify the contents of 
the band using F5 to place fields in the band. You can close a band that you 
are not using by moving the cursor to the band border and pressing Enter. Just 
remember to reopen the band before printing because closed bands do not print. 


5. A report band can be modified using either the layout editor or the word—wrap 
editor. Only the layout editor will be discussed here. The layout editor lets you place 
fields on the band, move them around, and add fields, boxes, and lines to the report. 

a. Adding fields: Position the cursor where you want the leftmost character of the 
field template to appear. Either press F5 (Field) or select Add Field from the 
Fields pull-down menu. Select a field, by positioning the highlight and pressing 
Enter, from the submenu of possible fields: 

1) database: those fields available from the current database or query 

2) calculated: display the results of dBase calculations 

3) predefined: those that dBase provides and handles automatically, including 
date, time, recno (record number), and pageno (page number) 

4) summary: average, count, max, min, sum, std, and var 

Press Ctrl-End to place the field and return to the design screen. A series of 
Xs (or Hs or Vs) fills in a portion of the screen. These are the field template, 
which show the max space that data will occupy on a printed page. 

b. Moving and copying fields: Place the cursor in a corner of the area you want to 
move and press F6 (Select). If you are moving only a field template, press 
Enter. If you are moving more than a single template, use the arrow keys to 
highlight the entire area that you want to move or copy and then press Enter. 
Press either F7 (Move) or F8 (Copy). Move the highlight to the new location 
and press Enter. 

c. Deleting fields: Move the cursor to the field template and either press Del or 
select Remove Field from the Fields menu. To delete an entire line, including 
all fields and text, move the cursor to the appropriate line and press Ctrl-Y. 

d. Adding and deleting text: To insert text into an existing format, position the cursor 
where you want the new text to appear. Make sure that Insert mode is on and 
then type your text. To change existing text, position the cursor on the text to 
be changed and activate Overwrite mode (press Ins until the Ins indicator 
disappears); when you type your changes, the new characters will replace 
existing characters. To delete text from the format, position the cursor on the 
character you want to delete and press Del. You can delete an entire section 
of text and fields by using the Select key (F6) to highlight the area you want to 
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delete; after pressing Enter to complete the selection, press Del to delete the 
entire highlighted block. 

e. Adding and deleting lines: To insert a new line on a report format, position the 
cursor where you want the new line to appear and then press Ctrl-N, select Add 
Line from the Words pull-down menu, or press Enter while in Insert mode. To 
delete a line from a report format, move the cursor to the line and either press 
Ctrl-Y or select Remove Line from the Words menu. 


The keys for editing report formats are: 


KEY EFFECT 
Enter If Insert mode is off, moves down one row; if Insert mode is on, inserts a 
new line 


Arrow-Left, Moves left or right one character or to end of field template 
-Right 


Arrow-Up, Moves up or down one row 
-Down 


PgUp,PgDn Moves to top or bottom of screen 


Home Moves to beginning of line 
End Moves to end of line 
Tab Moves to next tab setting 


Shift-Tab Moves to previous tab setting 

Ins Toggles Insert mode on/off 

Backspace’ Erases character to the left 

Del Deletes character, field template, or block selected with F6 

F1 (Help) Provides help 

FS (Field) |§ Adds a new field template or changes currently highlighted one 
F6 (Select) Selects field template or block 


F7 (Move) Moves field or block selected with F6 


sist. 


F8 (Copy) Copies field or block selected with F6 


Shift-F7 Changes size of currently selected field template 
(Size) | 

Ctrl-N Inserts a new line 

Ctrl-T Removes word or field to right 

Ctrl-Y Removes entire line 

Esc Abandons current format without saving changes 


Saving Report Formats 


1. Highlight Layout on the menu bar and select Edit Description of Report. Type a 
description and press Enter. 


2. Pull down either the Layout or Exit menu and select Save This Report or Save 
Changes and Exit, respectively. When dBase presents the prompt Save as., type a valid 
DOS file name and press Enter. After dBase has written a program for itself to print the 
report later, it will return you to the Control Center where you'll see the new report name 
in the Reports panel. 


Modifying Report Formats 


1. Highlight the name of the format in the Reports panel of the Control Center and 
press Shift-F2 (Design). You can also press Enter and then select Modify Layout from 
the submenu that appears. 


2. You'll be put in the report format design screen where you can make the changes 
you desire. 


3. After you’ve modified your format, save your work by selecting Save Changes and 
Exit from the Exit menu. If you do not want to save your changes, select Abandon 
Changes and Exit instead. You'll be returned to the Control Center. 


4. If you want to save your modified format as a new file (leaving the original, 


unmodified format intact), select Save This Report from the Layout menu and provide a 
new file name. Then select Abandon Changes and Exit from the Exit pull-down menu. 
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rinting 
The following sections will guide you through printing the database structure, 


printing a quick report, and printing customized reports. 


Printing the Database Structure 





You can print your database structure fairly easily from the Database Design screen. 


1. Highlight the database file name in the data panel and press the Shift-F2 key 
(Design). 


2. Select Print Database Structure from the Layout pull-down menu. 
3. Select Begin printing. 


4. Select Abandon Changes and Exit from the Exit menu to return to the Control 
Center. 


Printing a Quick Report 
dBase IV has a quick method of printing out a report of a file’s records. 


1. Move the pointer to the database file name in the Data panel or the view in the 
Queries panel which you want to print. Press Shift-F9. The Print box appears. 


2. With the Begin printing option highlighted, press the Enter key. Your print job is 
sent to the network printer. 


Printing Customized Reports 


1. Make sure the report format name is highlighted in the appropriate panel of the 
Control Center and press Enter. 


2. From the options that appear, select Print Report. 
3. From the Print menu that appears next, select either View Report on Screen (to see 


a screen display only) or Begin Printing (to actually print the text). If you select Begin 
Printing, your job is sent to the network printer immediately. 
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xiting dBase IV 


1. Return to the Control Center. 
2. Press F10 and move to the Exit menu. 


3. Move the pointer to Quit to DOS and press the Enter key. You should be returned 
to the DOS prompt in the 1DIR menu of the network. 


4. If you accidentally select Quit to Dot Prompt, type "QUIT" at the dot prompt and 
press Enter. 
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